{ "components": { "securitySchemes": { "bearerAuth": { "scheme": "bearer", "type": "http" } }, "schemas": { "Response1Fc51B60A782_ResponseModel": { "properties": { "code": { "type": "integer", "title": "Code", "description": "HTTP status code", "default": 200 }, "request_id": { "title": "Request Id", "description": "Unique request identifier", "type": [ "string", "null" ] }, "message": { "type": "string", "title": "Message", "description": "Response message (EN-US)", "default": "Request successful. This request will incur a charge." }, "message_zh": { "type": "string", "title": "Message Zh", "description": "Response message (ZH-CN)", "default": "请求成功，本次请求将被计费。" }, "support": { "type": "string", "title": "Support", "description": "Support message", "default": "Discord: https://discord.gg/aMEAS8Xsvz" }, "time": { "type": "string", "title": "Time", "description": "The time the response was generated" }, "time_stamp": { "type": "integer", "title": "Time Stamp", "description": "The timestamp the response was generated" }, "time_zone": { "type": "string", "title": "Time Zone", "description": "The timezone of the response time", "default": "America/Los_Angeles" }, "docs": { "title": "Docs", "description": "Link to the API Swagger documentation for this endpoint", "type": [ "string", "null" ] }, "cache_message": { "title": "Cache Message", "description": "Cache message (EN-US)", "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.", "type": [ "string", "null" ] }, "cache_message_zh": { "title": "Cache Message Zh", "description": "Cache message (ZH-CN)", "default": "本次响应已缓存，可通过下方 URL 直接查看，有效期 24 小时，访问缓存链接无额外费用。缓存仅用于请求溯源，不影响接口数据的时效性，也不会再次通过接口返回。", "type": [ "string", "null" ] }, "cache_url": { "title": "Cache Url", "description": "The URL to access the cached result", "type": [ "string", "null" ] }, "router": { "type": "string", "title": "Router", "description": "The endpoint that generated this response", "default": "" }, "params": { "title": "Params", "description": "The parameters used in the request", "default": {} }, "data": { "title": "Data", "description": "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." } }, "type": "object", "title": "ResponseModel" }, "Manual1Fc51B60A782_LiveSearchBody": { "properties": { "nickname_or_mids": { "title": "Nickname Or Mids", "description": "Search by creator nickname or UID", "type": [ "string", "null" ] }, "mids": { "title": "Mids", "description": "Batch exact match by UID", "items": { "type": "integer" }, "type": [ "array", "null" ] }, "is_brand_live": { "title": "Is Brand Live", "description": "Live stream type: 1=Content live stream, 0=Commerce live stream. Available filters differ between the two types.", "type": [ "integer", "null" ] }, "gender": { "title": "Gender", "description": "Anchor gender", "type": [ "string", "null" ] }, "region_id": { "title": "Region Id", "description": "Anchor primary residence region (level 1)", "items": { "type": "integer" }, "type": [ "array", "null" ] }, "second_region_id": { "title": "Second Region Id", "description": "Anchor primary residence region (level 2)", "items": { "type": "integer" }, "type": [ "array", "null" ] }, "min_fans_num": { "title": "Min Fans Num", "description": "Minimum follower count", "type": [ "integer", "null" ] }, "max_fans_num": { "title": "Max Fans Num", "description": "Maximum follower count", "type": [ "integer", "null" ] }, "fans_gender_tag": { "title": "Fans Gender Tag", "description": "Audience gender tag", "items": { "type": "string" }, "type": [ "array", "null" ] }, "fans_age_tag": { "title": "Fans Age Tag", "description": "Audience age tag", "items": { "type": "string" }, "type": [ "array", "null" ] }, "fans_region_tag": { "title": "Fans Region Tag", "description": "Audience region tag", "items": { "type": "string" }, "type": [ "array", "null" ] }, "live_subarea_id": { "title": "Live Subarea Id", "description": "Live area (second-level); see live_area_list for values\n\nAPI references: `live_area_list` = `GET /tikhub/bilibili/huahuo/live_area_list` (operationId: `get_tikhub_bilibili_huahuo_live_area_list`).", "items": { "type": "integer" }, "type": [ "array", "null" ] }, "partition_id": { "title": "Partition Id", "description": "Submission category (level 1)", "type": [ "integer", "null" ] }, "second_partition_id": { "title": "Second Partition Id", "description": "Submission category (level 2)", "items": { "type": "integer" }, "type": [ "array", "null" ] }, "min_popularity": { "title": "Min Popularity", "description": "Minimum average peak popularity per session in the last 30 days", "type": [ "integer", "null" ] }, "max_popularity": { "title": "Max Popularity", "description": "Maximum average peak popularity per session in the last 30 days", "type": [ "integer", "null" ] }, "live_audience_h_avg_30d_min": { "title": "Live Audience H Avg 30D Min", "description": "Minimum average hourly viewer count in the last 30 days", "type": [ "integer", "null" ] }, "live_audience_h_avg_30d_max": { "title": "Live Audience H Avg 30D Max", "description": "Maximum average hourly viewer count in the last 30 days", "type": [ "integer", "null" ] }, "live_danmu_h_avg_30d_min": { "title": "Live Danmu H Avg 30D Min", "description": "Minimum average hourly danmaku count in the last 30 days", "type": [ "integer", "null" ] }, "live_danmu_h_avg_30d_max": { "title": "Live Danmu H Avg 30D Max", "description": "Maximum average hourly danmaku count in the last 30 days", "type": [ "integer", "null" ] }, "live_guild_id": { "title": "Live Guild Id", "description": "Live streaming guild; see live_guild_drop for values\n\nAPI references: `live_guild_drop` = `GET /tikhub/bilibili/huahuo/live_guild_drop` (operationId: `get_tikhub_bilibili_huahuo_live_guild_drop`).", "items": { "type": "integer" }, "type": [ "array", "null" ] }, "high_potential_type": { "title": "High Potential Type", "description": "Registration status", "type": [ "integer", "null" ] }, "live_good_category": { "title": "Live Good Category", "description": "Primary commerce category; 0=all; valid values from live_good_category\n\nAPI references: `live_good_category` = `GET /tikhub/bilibili/huahuo/live_good_category` (operationId: `get_tikhub_bilibili_huahuo_live_good_category`).", "type": [ "integer", "null" ] }, "live_good_gmv": { "title": "Live Good Gmv", "description": "90-day GMV tier, 0=all", "type": [ "integer", "null" ] }, "order_by": { "title": "Order By", "description": "Sort field", "type": [ "string", "null" ] }, "sort": { "title": "Sort", "description": "Sort direction: desc or asc", "type": [ "string", "null" ] }, "page": { "title": "Page", "description": "Page number starting from 1; 20 items per page\n\nUsage: One-based page number. Each page contains 20 records.", "type": [ "integer", "null" ], "minimum": 1.0 } }, "additionalProperties": true, "type": "object", "title": "LiveSearchBody", "description": "Live collaboration marketplace filters. Supports creator attributes,\naudience demographics, live categories, content-live performance,\ncommerce categories, and GMV filters. Every field is optional, and\nadditional filter fields may be supplied." }, "Manual1Fc51B60A782_VIPVideoModel": { "properties": { "bv_id": { "type": "string", "title": "Bv Id", "description": "Video id", "example": "BV1y7411Q7Eq" }, "cid": { "type": "string", "title": "Cid", "description": "Video cid", "example": "171776208" }, "cookie": { "type": "string", "title": "Cookie", "description": "VIP User Cookie", "example": "your_vip_bilibili_cookie" } }, "type": "object", "required": [ "bv_id", "cid", "cookie" ], "title": "VIPVideoModel" }, "Manual1Fc51B60A782_FetchMultiVideoHighQualityPlayUrlRequest": { "properties": { "aweme_ids": { "type": "string", "title": "Aweme Ids", "description": "Video id list, separated by commas, for example: \"123,456,789\", up to 50.", "default": "7512756548356492544,7448118827402972455,7126745726494821640", "pattern": "^[^,]*(?:,[^,]*){0,49}$" }, "region": { "title": "Region", "description": "Optional, ISO country code (e.g. CN). Pass 'CN' for users in mainland China to get China-region CDN URLs for faster download.", "example": "CN", "type": [ "string", "null" ] } }, "type": "object", "title": "FetchMultiVideoHighQualityPlayUrlRequest" }, "Manual1Fc51B60A782_Body_fetch_hot_account_list_api_v1_douyin_billboard_fetch_hot_account_list_post": { "properties": { "date_window": { "type": "integer", "title": "Date Window", "description": "Time window (hours): 24=last 1 day, 72=last 3 days, 168=last 7 days; default 24\n\nUsage: Time window in hours, one of 24/72/168 (last 1 day / 3 days / 7 days), default 24", "default": 24 }, "page_num": { "type": "integer", "title": "Page Num", "description": "Page number, default 1", "default": 1 }, "page_size": { "type": "integer", "title": "Page Size", "description": "Number of items per page, default 10", "default": 10 }, "query_tag": { "description": "Vertical tag filter; leave empty for all. Tag IDs are obtained from the fetch_content_tag endpoint.\n\nUsage: Vertical category tag filter, empty for all, tag ids come from the fetch_content_tag endpoint\n\nAPI references: `fetch_content_tag` = `GET /tikhub/douyin/billboard/fetch_content_tag` (operationId: `get_tikhub_douyin_billboard_fetch_content_tag`).", "example": { "children": [ { "value": 62808 }, { "value": 62804 } ], "value": 628 }, "allOf": [ { "$ref": "#/components/schemas/Manual1Fc51B60A782_BillboardTag" } ] } }, "type": "object", "title": "Body_fetch_hot_account_list_api_v1_douyin_billboard_fetch_hot_account_list_post" }, "Manual1Fc51B60A782_BillboardTag": { "properties": { "value": { "title": "Value", "description": "Top-level vertical category tag id, obtained from the fetch_content_tag endpoint\n\nAPI references: `fetch_content_tag` = `GET /tikhub/douyin/billboard/fetch_content_tag` (operationId: `get_tikhub_douyin_billboard_fetch_content_tag`).", "type": [ "integer", "null" ] }, "children": { "title": "Children", "description": "Sub-level vertical category tags, omit for all under this top-level tag", "items": { "$ref": "#/components/schemas/Manual1Fc51B60A782_BillboardTagChild" }, "type": [ "array", "null" ] } }, "type": "object", "title": "BillboardTag" }, "Manual1Fc51B60A782_BillboardTagChild": { "properties": { "value": { "title": "Value", "description": "Sub-level vertical category tag id, obtained from the fetch_content_tag endpoint\n\nAPI references: `fetch_content_tag` = `GET /tikhub/douyin/billboard/fetch_content_tag` (operationId: `get_tikhub_douyin_billboard_fetch_content_tag`).", "type": [ "integer", "null" ] } }, "type": "object", "title": "BillboardTagChild" }, "Manual1Fc51B60A782_Body_fetch_hot_calendar_list_api_v1_douyin_billboard_fetch_hot_calendar_list_post": { "properties": { "city_code": { "type": "string", "title": "City Code", "description": "City code from city list; leave empty for all\n\nUsage: City code, get from city list, empty for all", "default": "" }, "category_code": { "type": "string", "title": "Category Code", "description": "Hot-spot ranking category code; obtained from the hot-spot ranking categories; leave empty for all\n\nUsage: Hot list category code, get from hot list category, empty for all", "default": "" }, "end_date": { "type": "integer", "title": "End Date", "description": "Snapshot end time, 10-digit Unix timestamp format\n\nUsage: Snapshot end time format 10 digit timestamp", "default": 1735488000 }, "start_date": { "type": "integer", "title": "Start Date", "description": "Snapshot start time format 10 digit timestamp", "default": 1734902400 } }, "type": "object", "title": "Body_fetch_hot_calendar_list_api_v1_douyin_billboard_fetch_hot_calendar_list_post" }, "Manual1Fc51B60A782_Body_fetch_hot_total_high_fan_list_api_v1_douyin_billboard_fetch_hot_total_high_fan_list_post": { "properties": { "page": { "type": "integer", "title": "Page", "description": "Page number", "default": 1 }, "page_size": { "type": "integer", "title": "Page Size", "description": "Items per page", "default": 10 }, "date_window": { "type": "integer", "title": "Date Window", "description": "Time window (hours): 1=last 1 hour, 24=last 1 day, 72=last 3 days, 168=last 7 days; default 24\n\nUsage: Time window in hours, one of 1/24/72/168 (last 1 hour / 1 day / 3 days / 7 days), default 24", "default": 24 }, "keyword": { "type": "string", "title": "Keyword", "description": "Search keyword for filtering the leaderboard; empty=all\n\nUsage: Search keyword to filter the billboard, empty for all", "default": "" }, "tags": { "items": { "$ref": "#/components/schemas/Manual1Fc51B60A782_BillboardTag" }, "type": "array", "title": "Tags", "description": "Vertical tag filter; leave empty for all. Tag IDs are obtained from the fetch_content_tag endpoint.\n\nUsage: Vertical category tag filter, empty for all, tag ids come from the fetch_content_tag endpoint\n\nAPI references: `fetch_content_tag` = `GET /tikhub/douyin/billboard/fetch_content_tag` (operationId: `get_tikhub_douyin_billboard_fetch_content_tag`).", "example": [ { "children": [ { "value": 62808 }, { "value": 62804 } ], "value": 628 } ] } }, "type": "object", "title": "Body_fetch_hot_total_high_fan_list_api_v1_douyin_billboard_fetch_hot_total_high_fan_list_post" }, "Manual1Fc51B60A782_Body_fetch_hot_total_high_like_list_api_v1_douyin_billboard_fetch_hot_total_high_like_list_post": { "properties": { "page": { "type": "integer", "title": "Page", "description": "Page number", "default": 1 }, "page_size": { "type": "integer", "title": "Page Size", "description": "Items per page", "default": 10 }, "date_window": { "type": "integer", "title": "Date Window", "description": "Time window (hours): 1=last 1 hour, 24=last 1 day, 72=last 3 days, 168=last 7 days; default 24\n\nUsage: Time window in hours, one of 1/24/72/168 (last 1 hour / 1 day / 3 days / 7 days), default 24", "default": 24 }, "keyword": { "type": "string", "title": "Keyword", "description": "Search keyword for filtering the leaderboard; empty=all\n\nUsage: Search keyword to filter the billboard, empty for all", "default": "" }, "tags": { "items": { "$ref": "#/components/schemas/Manual1Fc51B60A782_BillboardTag" }, "type": "array", "title": "Tags", "description": "Vertical tag filter; leave empty for all. Tag IDs are obtained from the fetch_content_tag endpoint.\n\nUsage: Vertical category tag filter, empty for all, tag ids come from the fetch_content_tag endpoint\n\nAPI references: `fetch_content_tag` = `GET /tikhub/douyin/billboard/fetch_content_tag` (operationId: `get_tikhub_douyin_billboard_fetch_content_tag`).", "example": [ { "children": [ { "value": 62808 }, { "value": 62804 } ], "value": 628 } ] } }, "type": "object", "title": "Body_fetch_hot_total_high_like_list_api_v1_douyin_billboard_fetch_hot_total_high_like_list_post" }, "Manual1Fc51B60A782_Body_fetch_hot_total_high_play_list_api_v1_douyin_billboard_fetch_hot_total_high_play_list_post": { "properties": { "page": { "type": "integer", "title": "Page", "description": "Page number", "default": 1 }, "page_size": { "type": "integer", "title": "Page Size", "description": "Items per page", "default": 10 }, "date_window": { "type": "integer", "title": "Date Window", "description": "Time window (hours): 1=last 1 hour, 24=last 1 day, 72=last 3 days, 168=last 7 days; default 24\n\nUsage: Time window in hours, one of 1/24/72/168 (last 1 hour / 1 day / 3 days / 7 days), default 24", "default": 24 }, "keyword": { "type": "string", "title": "Keyword", "description": "Search keyword for filtering the leaderboard; empty=all\n\nUsage: Search keyword to filter the billboard, empty for all", "default": "" }, "tags": { "items": { "$ref": "#/components/schemas/Manual1Fc51B60A782_BillboardTag" }, "type": "array", "title": "Tags", "description": "Vertical tag filter; leave empty for all. Tag IDs are obtained from the fetch_content_tag endpoint.\n\nUsage: Vertical category tag filter, empty for all, tag ids come from the fetch_content_tag endpoint\n\nAPI references: `fetch_content_tag` = `GET /tikhub/douyin/billboard/fetch_content_tag` (operationId: `get_tikhub_douyin_billboard_fetch_content_tag`).", "example": [ { "children": [ { "value": 62808 }, { "value": 62804 } ], "value": 628 } ] } }, "type": "object", "title": "Body_fetch_hot_total_high_play_list_api_v1_douyin_billboard_fetch_hot_total_high_play_list_post" }, "Manual1Fc51B60A782_Body_fetch_hot_total_high_search_list_api_v1_douyin_billboard_fetch_hot_total_high_search_list_post": { "properties": { "page_num": { "type": "integer", "title": "Page Num", "description": "Page number", "default": 1 }, "page_size": { "type": "integer", "title": "Page Size", "description": "Items per page", "default": 10 }, "date_window": { "type": "integer", "title": "Date Window", "description": "Time window (hours): 1=last 1 hour, 24=last 1 day, 72=last 3 days, 168=last 7 days; default 24\n\nUsage: Time window in hours, one of 1/24/72/168 (last 1 hour / 1 day / 3 days / 7 days), default 24", "default": 24 }, "keyword": { "type": "string", "title": "Keyword", "description": "Search keyword", "default": "抖音" } }, "type": "object", "title": "Body_fetch_hot_total_high_search_list_api_v1_douyin_billboard_fetch_hot_total_high_search_list_post" }, "Manual1Fc51B60A782_Body_fetch_hot_total_high_topic_list_api_v1_douyin_billboard_fetch_hot_total_high_topic_list_post": { "properties": { "page": { "type": "integer", "title": "Page", "description": "Page number", "default": 1 }, "page_size": { "type": "integer", "title": "Page Size", "description": "Items per page", "default": 10 }, "date_window": { "type": "integer", "title": "Date Window", "description": "Time window (hours): 1=last 1 hour, 24=last 1 day, 72=last 3 days, 168=last 7 days; default 24\n\nUsage: Time window in hours, one of 1/24/72/168 (last 1 hour / 1 day / 3 days / 7 days), default 24", "default": 24 }, "keyword": { "type": "string", "title": "Keyword", "description": "Search keyword for filtering the leaderboard; empty=all\n\nUsage: Search keyword to filter the billboard, empty for all", "default": "" }, "tags": { "items": { "$ref": "#/components/schemas/Manual1Fc51B60A782_BillboardTag" }, "type": "array", "title": "Tags", "description": "Vertical tag filter; leave empty for all. Tag IDs are obtained from the fetch_content_tag endpoint.\n\nUsage: Vertical category tag filter, empty for all, tag ids come from the fetch_content_tag endpoint\n\nAPI references: `fetch_content_tag` = `GET /tikhub/douyin/billboard/fetch_content_tag` (operationId: `get_tikhub_douyin_billboard_fetch_content_tag`).", "example": [ { "children": [ { "value": 62808 }, { "value": 62804 } ], "value": 628 } ] } }, "type": "object", "title": "Body_fetch_hot_total_high_topic_list_api_v1_douyin_billboard_fetch_hot_total_high_topic_list_post" }, "Manual1Fc51B60A782_Body_fetch_hot_total_hot_word_list_api_v1_douyin_billboard_fetch_hot_total_hot_word_list_post": { "properties": { "page_num": { "type": "integer", "title": "Page Num", "description": "Page number", "default": 1 }, "page_size": { "type": "integer", "title": "Page Size", "description": "Items per page", "default": 10 }, "date_window": { "type": "integer", "title": "Date Window", "description": "Time window (hours): 24=last 1 day, 72=last 3 days, 168=last 7 days; default 24\n\nUsage: Time window in hours, one of 24/72/168 (last 1 day / 3 days / 7 days), default 24", "default": 24 }, "keyword": { "type": "string", "title": "Keyword", "description": "Search keyword", "default": "抖音" } }, "type": "object", "title": "Body_fetch_hot_total_hot_word_list_api_v1_douyin_billboard_fetch_hot_total_hot_word_list_post" }, "Manual1Fc51B60A782_Body_fetch_hot_total_low_fan_list_api_v1_douyin_billboard_fetch_hot_total_low_fan_list_post": { "properties": { "page": { "type": "integer", "title": "Page", "description": "Page number", "default": 1 }, "page_size": { "type": "integer", "title": "Page Size", "description": "Items per page", "default": 10 }, "date_window": { "type": "integer", "title": "Date Window", "description": "Time window (hours): 1=last 1 hour, 24=last 1 day, 72=last 3 days, 168=last 7 days; default 24\n\nUsage: Time window in hours, one of 1/24/72/168 (last 1 hour / 1 day / 3 days / 7 days), default 24", "default": 24 }, "keyword": { "type": "string", "title": "Keyword", "description": "Search keyword for filtering the leaderboard; empty=all\n\nUsage: Search keyword to filter the billboard, empty for all", "default": "" }, "tags": { "items": { "$ref": "#/components/schemas/Manual1Fc51B60A782_BillboardTag" }, "type": "array", "title": "Tags", "description": "Vertical tag filter; leave empty for all. Tag IDs are obtained from the fetch_content_tag endpoint.\n\nUsage: Vertical category tag filter, empty for all, tag ids come from the fetch_content_tag endpoint\n\nAPI references: `fetch_content_tag` = `GET /tikhub/douyin/billboard/fetch_content_tag` (operationId: `get_tikhub_douyin_billboard_fetch_content_tag`).", "example": [ { "children": [ { "value": 62808 }, { "value": 62804 } ], "value": 628 } ] } }, "type": "object", "title": "Body_fetch_hot_total_low_fan_list_api_v1_douyin_billboard_fetch_hot_total_low_fan_list_post" }, "Manual1Fc51B60A782_Body_fetch_hot_total_search_list_api_v1_douyin_billboard_fetch_hot_total_search_list_post": { "properties": { "page_num": { "type": "integer", "title": "Page Num", "description": "Page number", "default": 1 }, "page_size": { "type": "integer", "title": "Page Size", "description": "Items per page", "default": 10 }, "date_window": { "type": "integer", "title": "Date Window", "description": "Time window (hours): 1=last 1 hour, 24=last 1 day, 72=last 3 days, 168=last 7 days; default 24\n\nUsage: Time window in hours, one of 1/24/72/168 (last 1 hour / 1 day / 3 days / 7 days), default 24", "default": 24 }, "keyword": { "type": "string", "title": "Keyword", "description": "Search keyword", "default": "抖音" } }, "type": "object", "title": "Body_fetch_hot_total_search_list_api_v1_douyin_billboard_fetch_hot_total_search_list_post" }, "Manual1Fc51B60A782_Body_fetch_hot_total_topic_list_api_v1_douyin_billboard_fetch_hot_total_topic_list_post": { "properties": { "page": { "type": "integer", "title": "Page", "description": "Page number", "default": 1 }, "page_size": { "type": "integer", "title": "Page Size", "description": "Items per page", "default": 10 }, "date_window": { "type": "integer", "title": "Date Window", "description": "Time window (hours): 1=last 1 hour, 24=last 1 day, 72=last 3 days, 168=last 7 days; default 24\n\nUsage: Time window in hours, one of 1/24/72/168 (last 1 hour / 1 day / 3 days / 7 days), default 24", "default": 24 }, "keyword": { "type": "string", "title": "Keyword", "description": "Search keyword for filtering the leaderboard; empty=all\n\nUsage: Search keyword to filter the billboard, empty for all", "default": "" }, "tags": { "items": { "$ref": "#/components/schemas/Manual1Fc51B60A782_BillboardTag" }, "type": "array", "title": "Tags", "description": "Vertical tag filter; leave empty for all. Tag IDs are obtained from the fetch_content_tag endpoint.\n\nUsage: Vertical category tag filter, empty for all, tag ids come from the fetch_content_tag endpoint\n\nAPI references: `fetch_content_tag` = `GET /tikhub/douyin/billboard/fetch_content_tag` (operationId: `get_tikhub_douyin_billboard_fetch_content_tag`).", "example": [ { "children": [ { "value": 62808 }, { "value": 62804 } ], "value": 628 } ] } }, "type": "object", "title": "Body_fetch_hot_total_topic_list_api_v1_douyin_billboard_fetch_hot_total_topic_list_post" }, "Manual1Fc51B60A782_Body_fetch_hot_total_video_list_api_v1_douyin_billboard_fetch_hot_total_video_list_post": { "properties": { "page": { "type": "integer", "title": "Page", "description": "Page number, default 1", "default": 1 }, "page_size": { "type": "integer", "title": "Page Size", "description": "Items per page, default 10", "default": 10 }, "date_window": { "type": "integer", "title": "Date Window", "description": "Time window (hours): 1=last 1 hour, 24=last 1 day, 72=last 3 days, 168=last 7 days; default 24\n\nUsage: Time window in hours, one of 1/24/72/168 (last 1 hour / 1 day / 3 days / 7 days), default 24", "default": 24 }, "sub_type": { "type": "integer", "title": "Sub Type", "description": "Ranking category: 1001 Overall Video, 1002 Low-follower Viral, 1003 High Completion Rate, 1004 High Follower Growth Rate, 1005 High Like Rate", "default": 1001 }, "keyword": { "type": "string", "title": "Keyword", "description": "Search keyword for filtering the leaderboard; empty=all\n\nUsage: Search keyword to filter the billboard, empty for all", "default": "" }, "tags": { "items": { "$ref": "#/components/schemas/Manual1Fc51B60A782_BillboardTag" }, "type": "array", "title": "Tags", "description": "Vertical tag filter; leave empty for all. Tag IDs are obtained from the fetch_content_tag endpoint.\n\nUsage: Vertical category tag filter, empty for all, tag ids come from the fetch_content_tag endpoint\n\nAPI references: `fetch_content_tag` = `GET /tikhub/douyin/billboard/fetch_content_tag` (operationId: `get_tikhub_douyin_billboard_fetch_content_tag`).", "example": [ { "children": [ { "value": 62808 }, { "value": 62804 } ], "value": 628 } ] } }, "type": "object", "title": "Body_fetch_hot_total_video_list_api_v1_douyin_billboard_fetch_hot_total_video_list_post" }, "Manual1Fc51B60A782_AuthorDiagnosisRequest": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User's Douyin Creator Platform Cookie (required)", "example": "Your_Cookie_Here" } }, "type": "object", "required": [ "cookie" ], "title": "AuthorDiagnosisRequest", "description": "Author Diagnosis Request Model\n\nThis API requires no additional parameters, automatically fetches diagnosis data for the past 7 days" }, "Manual1Fc51B60A782_ItemAnalysisInvolvedVerticalRequest": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User's Douyin Creator Platform Cookie (required, transmitted in request body)", "example": "Your_Cookie_Here" }, "start_date": { "type": "string", "title": "Start Date", "description": "Start date (format YYYYMMDD)", "example": "20250713" }, "end_date": { "type": "string", "title": "End Date", "description": "End date (format YYYYMMDD)", "example": "20251011" } }, "type": "object", "required": [ "cookie", "start_date", "end_date" ], "title": "ItemAnalysisInvolvedVerticalRequest", "description": "Item Analysis Involved Vertical Request Model" }, "Manual1Fc51B60A782_ItemAnalysisItemPerformanceRequest": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User's Douyin Creator Platform Cookie (required, transmitted in request body)", "example": "Your_Cookie_Here" }, "start_date": { "type": "string", "title": "Start Date", "description": "Start date (format YYYYMMDD)", "example": "20250713" }, "end_date": { "type": "string", "title": "End Date", "description": "End date (format YYYYMMDD)", "example": "20251011" }, "genres": { "items": { "type": "integer" }, "type": "array", "title": "Genres", "description": "Genres list: 1=video under 1 min, 2=1-3 min video, 3=3-5 min video, 4=video over 5 min, 5=image+text, 8=long-form article\n\nUsage: Genre type list (optional, defaults to all genres)\n - 1: Videos under 1 minute\n - 2: 1-3 minute videos\n - 3: 3-5 minute videos\n - 4: Videos over 5 minutes\n - 5: Photo posts\n - 8: Long photo posts", "default": [ 1, 2, 3, 4, 5, 8 ], "example": [ 2, 3, 4, 5, 8 ] }, "primary_verticals": { "items": { "type": "string" }, "type": "array", "title": "Primary Verticals", "description": "Primary verticals list (obtained from the involved_vertical endpoint)\n\nUsage: Vertical tag list (required, obtained from fetch_item_analysis_involved_vertical)\n\nAPI references: `fetch_item_analysis_involved_vertical` = `POST /tikhub/douyin/creator_v2/fetch_item_analysis_involved_vertical` (operationId: `post_tikhub_douyin_creator_v2_fetch_item_analysis_involved_vertical`).", "example": [ "动物" ] }, "metric_type": { "type": "integer", "title": "Metric Type", "description": "Metric type: 1=Views, 2=Likes, 3=Comments, 4=Shares", "default": 1, "example": 1 } }, "type": "object", "required": [ "cookie", "start_date", "end_date", "primary_verticals" ], "title": "ItemAnalysisItemPerformanceRequest", "description": "Item Analysis Item Performance Request Model" }, "Manual1Fc51B60A782_ItemAnalysisOverviewRequest": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User's Douyin Creator Platform Cookie (required, transmitted in request body)", "example": "Your_Cookie_Here" }, "start_date": { "type": "string", "title": "Start Date", "description": "Start date (format YYYYMMDD)", "example": "20250713" }, "end_date": { "type": "string", "title": "End Date", "description": "End date (format YYYYMMDD)", "example": "20251011" }, "genres": { "items": { "type": "integer" }, "type": "array", "title": "Genres", "description": "Genres list: 1=video under 1 min, 2=1-3 min video, 3=3-5 min video, 4=video over 5 min, 5=image+text, 8=long-form article\n\nUsage: Genre type list (optional, defaults to all genres)\n - 1: Videos under 1 minute\n - 2: 1-3 minute videos\n - 3: 3-5 minute videos\n - 4: Videos over 5 minutes\n - 5: Photo posts\n - 8: Long photo posts", "default": [ 1, 2, 3, 4, 5, 8 ], "example": [ 1, 2, 3, 4, 5, 8 ] }, "primary_verticals": { "items": { "type": "string" }, "type": "array", "title": "Primary Verticals", "description": "Primary verticals list (obtained from the involved_vertical endpoint)\n\nUsage: Vertical tag list (required, obtained from fetch_item_analysis_involved_vertical)\n\nAPI references: `fetch_item_analysis_involved_vertical` = `POST /tikhub/douyin/creator_v2/fetch_item_analysis_involved_vertical` (operationId: `post_tikhub_douyin_creator_v2_fetch_item_analysis_involved_vertical`).", "example": [ "动物" ] } }, "type": "object", "required": [ "cookie", "start_date", "end_date", "primary_verticals" ], "title": "ItemAnalysisOverviewRequest", "description": "Item Analysis Overview Request Model" }, "Manual1Fc51B60A782_ItemAudienceOthersRequest": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User's Douyin Creator Platform Cookie (required, transmitted in request body)", "example": "Your_Cookie_Here" }, "item_id": { "type": "string", "title": "Item Id", "description": "Item ID", "example": "7559536212910853422" } }, "type": "object", "required": [ "cookie", "item_id" ], "title": "ItemAudienceOthersRequest", "description": "Item Audience Others Request Model" }, "Manual1Fc51B60A782_ItemAudiencePortraitRequest": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User's Douyin Creator Platform Cookie (required, transmitted in request body)", "example": "Your_Cookie_Here" }, "item_id": { "type": "string", "title": "Item Id", "description": "Item ID", "example": "7559536212910853422" } }, "type": "object", "required": [ "cookie", "item_id" ], "title": "ItemAudiencePortraitRequest", "description": "Item Audience Portrait Request Model" }, "Manual1Fc51B60A782_ItemBulletAnalysisRequest": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User's Douyin Creator Platform Cookie (required, transmitted in request body)", "example": "Your_Cookie_Here" }, "item_id": { "type": "string", "title": "Item Id", "description": "Item ID", "example": "7559536212910853422" } }, "type": "object", "required": [ "cookie", "item_id" ], "title": "ItemBulletAnalysisRequest", "description": "Item Bullet Analysis Request Model" }, "Manual1Fc51B60A782_ItemListRequest": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User's Douyin Creator Platform Cookie (required, transmitted in request body)", "example": "Your_Cookie_Here" }, "count": { "type": "integer", "title": "Count", "description": "Count per page (max 100)\n\nUsage: Number of items per page, default 10, max 100 (optional)", "default": 10, "example": 10, "maximum": 100 }, "order_by": { "type": "integer", "title": "Order By", "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)", "default": 1, "example": 1 }, "fields": { "type": "string", "title": "Fields", "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", "default": "metrics,review,visibility", "example": "metrics,review,visibility" }, "need_cooperation": { "type": "boolean", "title": "Need Cooperation", "description": "Need cooperation info", "default": true, "example": true }, "start_time": { "type": "integer", "title": "Start Time", "description": "Start timestamp (milliseconds)", "example": 1758988800000 }, "end_time": { "type": "integer", "title": "End Time", "description": "End time timestamp (milliseconds)", "example": 1760198399000 }, "need_long_article": { "type": "boolean", "title": "Need Long Article", "description": "Include long articles", "default": true, "example": true }, "cursor": { "title": "Cursor", "description": "Pagination cursor, don't pass for first request, use returned cursor for pagination (optional)", "type": [ "integer", "null" ] } }, "type": "object", "required": [ "cookie", "start_time", "end_time" ], "title": "ItemListRequest", "description": "Item List Request Model" }, "Manual1Fc51B60A782_ItemListDownloadRequest": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User's Douyin Creator Platform Cookie (required, transmitted in request body)", "example": "Your_Cookie_Here" }, "min_cursor": { "type": "integer", "title": "Min Cursor", "description": "Min cursor (start timestamp in milliseconds)", "example": 1752336000000 }, "max_cursor": { "type": "integer", "title": "Max Cursor", "description": "Max cursor (end timestamp in milliseconds)", "example": 1760198399000 }, "type_filters": { "items": { "type": "integer" }, "type": "array", "title": "Type Filters", "description": "Type filters: 1=video under 1 min, 2=1-3 min video, 3=3-5 min video, 4=video over 5 min, 5=image+text, 8=long-form article\n\nUsage: Genre type filter list, default all [1,2,3,4,5,8] (optional)\n - **1**: Videos under 1 minute\n - **2**: 1-3 minute videos\n - **3**: 3-5 minute videos\n - **4**: Videos over 5 minutes\n - **5**: Image posts\n - **8**: Long image posts", "default": [ 1, 2, 3, 4, 5, 8 ], "example": [ 2, 3, 4, 5, 1, 8 ] }, "need_long_article": { "type": "boolean", "title": "Need Long Article", "description": "Include long articles", "default": true, "example": true } }, "type": "object", "required": [ "cookie", "min_cursor", "max_cursor" ], "title": "ItemListDownloadRequest", "description": "Item List Download Request Model" }, "Manual1Fc51B60A782_ItemMgetRequest": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User's Douyin Creator Platform Cookie (required, transmitted in request body)", "example": "Your_Cookie_Here" }, "ids": { "type": "string", "title": "Ids", "description": "Item ID list, separated by comma (e.g., \"7559536212910853422,7559536212910853423\")", "example": "7559536212910853422,7559536212910853423" }, "fields": { "title": "Fields", "description": "Fields to return, separated by comma. Optional values: metrics, review, play_info, dou_plus, integrated_incentive, incentive_life, content_analysis\n\nUsage: Fields to return, default is \"metrics,review,play_info,dou_plus,integrated_incentive,incentive_life,content_analysis\"\n - Available fields (comma-separated, customizable):\n - metrics: Traffic metrics data (views, likes, comments, etc.)\n - review: Review status information\n - play_info: Play related information\n - dou_plus: DOU+ promotion information\n - integrated_incentive: Integrated incentive data\n - incentive_life: Incentive lifecycle information\n - content_analysis: Content analysis data", "default": "metrics,review,play_info,dou_plus,integrated_incentive,incentive_life,content_analysis", "type": [ "string", "null" ] } }, "type": "object", "required": [ "cookie", "ids" ], "title": "ItemMgetRequest", "description": "Item Overview Data Request Model" }, "Manual1Fc51B60A782_ItemPlaySourceRequest": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User's Douyin Creator Platform Cookie (required, transmitted in request body)", "example": "Your_Cookie_Here" }, "item_id": { "type": "string", "title": "Item Id", "description": "Item ID", "example": "7559536212910853422" } }, "type": "object", "required": [ "cookie", "item_id" ], "title": "ItemPlaySourceRequest", "description": "Item Play Source Statistics Request Model" }, "Manual1Fc51B60A782_ItemSearchKeywordRequest": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User's Douyin Creator Platform Cookie (required, transmitted in request body)", "example": "Your_Cookie_Here" }, "item_id": { "type": "string", "title": "Item Id", "description": "Item ID", "example": "7559536212910853422" } }, "type": "object", "required": [ "cookie", "item_id" ], "title": "ItemSearchKeywordRequest", "description": "Item Search Keywords Request Model" }, "Manual1Fc51B60A782_ItemWatchTrendRequest": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User's Douyin Creator Platform Cookie (required, transmitted in request body)", "example": "Your_Cookie_Here" }, "item_id": { "type": "string", "title": "Item Id", "description": "Item ID", "example": "7559536212910853422" }, "analysis_type": { "type": "integer", "title": "Analysis Type", "description": "Analysis type: 1=Retention, 2=Like, 7=Bounce\n\nUsage: Analysis type (optional, default is 1)\n - **1**: Retention Analysis - Shows user retention at each time point\n - **2**: Like Analysis - Shows user like behavior at each time point\n - **7**: Bounce Analysis - Shows user bounce rate at each time point", "default": 1, "example": 1 } }, "type": "object", "required": [ "cookie", "item_id" ], "title": "ItemWatchTrendRequest", "description": "Item Watch Trend Analysis Request Model" }, "Manual1Fc51B60A782_LiveRoomHistoryListRequest": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User's Douyin Creator Platform Cookie (required, transmitted in request body)", "example": "Your_Cookie_Here" }, "start_date": { "type": "string", "title": "Start Date", "description": "Start date in YYYY-MM-DD format (required, e.g., \"2025-09-11\")", "example": "2025-09-11" }, "end_date": { "type": "string", "title": "End Date", "description": "End date in YYYY-MM-DD format (required, e.g., \"2025-10-11\")", "example": "2025-10-11" }, "limit": { "type": "integer", "title": "Limit", "description": "Limit per page, default 400, max 400", "default": 400, "example": 400, "maximum": 400 }, "need_living": { "type": "integer", "title": "Need Living", "description": "Include live rooms currently streaming: 0=exclude, 1=include", "default": 1, "example": 1 }, "download": { "type": "integer", "title": "Download", "description": "Download: 0=no download, 1=download\n\nUsage: Download flag (0=No download, 1=Download, default 0)", "default": 0, "example": 0 } }, "type": "object", "required": [ "cookie", "start_date", "end_date" ], "title": "LiveRoomHistoryListRequest", "description": "Live Room History List Request Model" }, "Manual1Fc51B60A782_CostEstimateRequest": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User www.douyin.com web Cookie", "example": "Your_Cookie_Here" }, "sec_uid": { "type": "string", "title": "Sec Uid", "description": "Delivery account sec_uid", "example": "MS4wLjABAAAA9fe7vGjwyiaOjL6REhX8rvmSb32VzA_XsKca9F3_YSHRXlEqgT2cpX54WGbtgnsA" }, "item_ids": { "type": "string", "title": "Item Ids", "description": "Item ID(s), comma separated", "example": "7651166972160446949" }, "target_id": { "title": "Target Id", "description": "Promotion target ID. 31=Likes & Comments, 32=Followers, 33=Profile visits, 37=Video views, 45=Comment link clicks, 78=High-quality engagement", "default": 31, "example": 31, "type": [ "integer", "null" ] } }, "type": "object", "required": [ "cookie", "sec_uid", "item_ids" ], "title": "CostEstimateRequest", "description": "DOU+ Cost Estimation Request Model" }, "Manual1Fc51B60A782_AnalyseStatsRequest": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User www.douyin.com web Cookie", "example": "Your_Cookie_Here" }, "query": { "additionalProperties": true, "type": "object", "title": "Query", "description": "Analysis query object. Key fields: startTime, endTime (second timestamp string); analysisType (1=account, 2=video, 3=live); authorSecIdList (account sec_uid list); statusList (delivery status filter); metrics (metric list, e.g. stat_cost, total_play, total_like, dy_comment, dy_share, dy_follow); SecondaryTargetIds; CollectWayIds. graph extra: dimension; detail extra: page, limit, orderByMetric, orderByType; video/live extra: liveRoomIdList", "example": { "CollectWayIds": [], "SecondaryTargetIds": [], "analysisType": 1, "authorSecIdList": [], "endTime": "1781625599", "metrics": [ "stat_cost", "total_play", "play_duration_5s_rate", "total_like", "dy_comment", "dy_share", "dy_home_visited", "dy_follow" ], "startTime": "1780934400", "statusList": [] } } }, "type": "object", "required": [ "cookie", "query" ], "title": "AnalyseStatsRequest", "description": "Delivery Analysis Request Model (overview / graph / detail, query passthrough)" }, "Manual1Fc51B60A782_DeliveryEffectEstimateRequest": { "properties": { "item_ids": { "type": "string", "minLength": 1, "title": "Item Ids", "description": "Item id(s), comma separated; normally use schema=0 for one item and schema=3 for multiple items", "example": "7677202522116819185" }, "external_action": { "type": "integer", "title": "External Action", "description": "Optimization action code; must match target_id, default 44 (NativeAction). Common values: 45=like, 46=follow, 47=comment, 51=link click, 102=multiple native actions, 181=homepage visit", "default": 44, "example": 44 }, "target_id": { "type": "integer", "title": "Target Id", "description": "Promotion target id, default 31 (likes and comments). Common values: 32=followers, 33=homepage visits, 37=video plays, 40=live popularity, 45=comment-link clicks, 63=show to followers, 78=natural promotion, 81=high interaction frequency", "default": 31, "example": 31 }, "schema": { "type": "integer", "title": "Schema", "description": "Delivery schema: 0=single-item Default, 3=multi-item BatchDelivery; the official client selects it from the item count", "default": 0, "example": 0 }, "is_max_cv": { "type": "boolean", "title": "Is Max Cv", "description": "Whether to estimate in MaxCV (maximum-conversion-volume) mode; the official client derives it from target capability, item count, budget and manual-bid state, default true", "default": true, "example": true }, "pay_type": { "type": "integer", "maximum": 3.0, "minimum": 0.0, "title": "Pay Type", "description": "Payment channel: 0=CashDesk, 1=IAP, 2=Caijing, 3=CgTradeCash; the official estimate request uses 1", "default": 1, "example": 1 }, "cost_int": { "type": "integer", "title": "Cost Int", "description": "1000), default 30000 (CNY 30", "default": 30000, "example": 30000, "exclusiveMinimum": 0 }, "duration_seconds": { "type": "integer", "title": "Duration Seconds", "description": "Delivery duration in seconds, default 21600 (6 hours", "default": 21600, "example": 21600, "exclusiveMinimum": 0 } }, "type": "object", "required": [ "item_ids" ], "title": "DeliveryEffectEstimateRequest", "description": "DOU+ Delivery Effect Estimate Request Model" }, "Manual1Fc51B60A782_PromotableItemListRequest": { "properties": { "sec_uid": { "type": "string", "title": "Sec Uid", "description": "Delivery account sec_uid", "example": "MS4wLjABAAAA9fe7vGjwyiaOjL6REhX8rvmSb32VzA_XsKca9F3_YSHRXlEqgT2cpX54WGbtgnsA" }, "count": { "title": "Count", "description": "Number of items, default 30", "default": 30, "example": 30, "type": [ "integer", "null" ] }, "target_id": { "title": "Target Id", "description": "Promotion target ID (the goal card on the DOU+ page). 31=Likes & Comments, 32=Followers, 33=Profile visits, 37=Video views, 40=Live room popularity, 45=Comment link clicks, 63=Shown to followers, 78=High-quality engagement. Only filters promotable items by goal; keep 31 for a plain video list", "default": 31, "example": 31, "type": [ "integer", "null" ] }, "aim_ids": { "title": "Aim Ids", "description": "Optional advanced param: optimization objective code(s), comma separated; leave empty (auto-matched by target_id), usually no need to set", "type": [ "string", "null" ] } }, "type": "object", "required": [ "sec_uid" ], "title": "PromotableItemListRequest", "description": "Promotable Item List Request Model" }, "Manual1Fc51B60A782_PromotedAccountsRequest": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User www.douyin.com web Cookie", "example": "Your_Cookie_Here" }, "limit": { "title": "Limit", "description": "Number of accounts per page, default 20", "default": 20, "example": 20, "type": [ "integer", "null" ] }, "cursor": { "title": "Cursor", "description": "Pagination cursor, empty for first page, then pass the `sortID` value from the previous response", "default": "", "example": "", "type": [ "string", "null" ] } }, "type": "object", "required": [ "cookie" ], "title": "PromotedAccountsRequest", "description": "Promoted Accounts Request Model" }, "Manual1Fc51B60A782_SecTokenRequest": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User www.douyin.com web Cookie", "example": "Your_Cookie_Here" } }, "type": "object", "required": [ "cookie" ], "title": "SecTokenRequest", "description": "Sec Token Request Model (cookie only)" }, "Manual1Fc51B60A782_TalentCategoryRequest": { "properties": { "cookie": { "title": "Cookie", "description": "User www.douyin.com web Cookie", "type": [ "string", "null" ] } }, "type": "object", "title": "TalentCategoryRequest", "description": "Talent Category List Request Model" }, "Manual1Fc51B60A782_TalentByCategoryRequest": { "properties": { "cookie": { "title": "Cookie", "description": "User www.douyin.com web Cookie", "type": [ "string", "null" ] }, "name": { "title": "Name", "description": "Category name or keyword (from the talent category endpoint); empty for all", "default": "", "example": "音乐", "type": [ "string", "null" ] }, "page": { "title": "Page", "description": "Page index from 0", "default": 0, "example": 0, "type": [ "integer", "null" ] }, "limit": { "title": "Limit", "description": "Page size, default 20", "default": 20, "example": 20, "type": [ "integer", "null" ] } }, "type": "object", "title": "TalentByCategoryRequest", "description": "Search Talents By Category Request Model" }, "Manual1Fc51B60A782_UserPostsRequest": { "properties": { "cookie": { "title": "Cookie", "description": "User www.douyin.com web Cookie", "type": [ "string", "null" ] }, "sec_uid": { "type": "string", "title": "Sec Uid", "description": "User sec_uid", "example": "MS4wLjABAAAA9fe7vGjwyiaOjL6REhX8rvmSb32VzA_XsKca9F3_YSHRXlEqgT2cpX54WGbtgnsA" }, "cursor": { "title": "Cursor", "description": "Pagination cursor (string), \"0\" for first page, then pass the cursor from the previous response", "default": "0", "example": "0", "type": [ "string", "null" ] }, "count": { "title": "Count", "description": "Page size, default 10", "default": 10, "example": 10, "type": [ "integer", "null" ] } }, "type": "object", "required": [ "sec_uid" ], "title": "UserPostsRequest", "description": "User Homepage Posts Request Model" }, "Manual1Fc51B60A782_VideoDetailRequest": { "properties": { "cookie": { "title": "Cookie", "description": "User www.douyin.com web Cookie", "type": [ "string", "null" ] }, "video": { "type": "string", "title": "Video", "description": "Video ID, or share link/text. e.g. \"7651708301280906538\" or a share message containing a v.douyin.com link", "example": "7651708301280906538" } }, "type": "object", "required": [ "video" ], "title": "VideoDetailRequest", "description": "Video Detail Request Model (by video ID or link)" }, "Manual1Fc51B60A782_VideoRankingRequest": { "properties": { "time_range": { "title": "Time Range", "description": "Time range: 1 / 2 / 3", "default": 2, "example": 2, "type": [ "integer", "null" ] }, "tag_id": { "title": "Tag Id", "description": "Category id. 601 Drama, 602 Celebrity, 606 Music, 607 Anime, 608 Gaming, 609 Current Affairs, 612 Dance, 614 Agriculture, 615 Technology, 616 Finance, 617 Parenting, 619 Lifestyle, 621 Health, 623 Emotions, 624 Culture, 625 Workplace, 626 Education, 627 Photography, 628 Food, 629 Travel, 631 Fashion, 633 Sports, 634 Entertainment, 635 Automotive", "default": 634, "example": 634, "type": [ "integer", "null" ] }, "dim_type": { "title": "Dim Type", "description": "Ranking dimension: 1=Low-follower Viral, 2=High Completion Rate, 3=High Like Rate, 4=High Follower Growth Rate, 5=Popularity Index", "default": 5, "example": 5, "type": [ "integer", "null" ] }, "adv_id": { "title": "Adv Id", "description": "Advertiser id (optional)", "default": "", "example": "", "type": [ "string", "null" ] } }, "type": "object", "title": "VideoRankingRequest", "description": "DOU+ Video Ranking Request Model" }, "Manual1Fc51B60A782_LiveRoomSearchRequest": { "properties": { "cookie": { "title": "Cookie", "description": "User www.douyin.com web Cookie", "type": [ "string", "null" ] }, "keyword": { "type": "string", "title": "Keyword", "description": "Douyin ID or nickname", "example": "Xiao Erduo" }, "cursor": { "title": "Cursor", "description": "Pagination cursor, 0 for first page, then pass the cursor from the previous response", "default": 0, "example": 0, "type": [ "integer", "null" ] }, "count": { "title": "Count", "description": "Page size, default 10", "default": 10, "example": 10, "type": [ "integer", "null" ] } }, "type": "object", "required": [ "keyword" ], "title": "LiveRoomSearchRequest", "description": "Live Room Search Request Model (by Douyin ID or nickname)" }, "Manual1Fc51B60A782_UserSearchV2Request": { "properties": { "cookie": { "title": "Cookie", "description": "User www.douyin.com web Cookie", "type": [ "string", "null" ] }, "keyword": { "type": "string", "title": "Keyword", "description": "Search keyword", "example": "Bo" }, "cursor": { "title": "Cursor", "description": "Pagination cursor, 0 for first page, then pass the cursor from the previous response", "default": 0, "example": 0, "type": [ "integer", "null" ] }, "count": { "title": "Count", "description": "Page size, default 10", "default": 10, "example": 10, "type": [ "integer", "null" ] }, "scope": { "title": "Scope", "description": "Search scope, default 1", "default": 1, "example": 1, "type": [ "integer", "null" ] } }, "type": "object", "required": [ "keyword" ], "title": "UserSearchV2Request", "description": "DOU+ User Search V2 Request Model" }, "Manual1Fc51B60A782_VideoSearchRequest": { "properties": { "cookie": { "title": "Cookie", "description": "User www.douyin.com web Cookie", "type": [ "string", "null" ] }, "keyword": { "type": "string", "title": "Keyword", "description": "Video title or keyword", "example": "major" }, "cursor": { "title": "Cursor", "description": "Pagination cursor, 0 for first page, then pass the cursor from the previous response", "default": 0, "example": 0, "type": [ "integer", "null" ] }, "count": { "title": "Count", "description": "Page size, default 12", "default": 12, "example": 12, "type": [ "integer", "null" ] } }, "type": "object", "required": [ "keyword" ], "title": "VideoSearchRequest", "description": "Video Search Request Model (by title/keyword)" }, "Manual1Fc51B60A782_ChallengeSearchV2Request": { "properties": { "keyword": { "type": "string", "title": "Keyword", "description": "Keyword", "default": "猫咪" }, "cursor": { "type": "integer", "title": "Cursor", "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)", "default": 0 }, "sort_type": { "type": "string", "title": "Sort Type", "description": "Sort type: 0=Comprehensive, 1=Most Likes, 2=Latest\n\nUsage: Sorting method\n - `0`: Comprehensive\n - `1`: Most likes\n - `2`: Latest", "default": "0" }, "publish_time": { "type": "string", "title": "Publish Time", "description": "Publish time filter: 0=Unlimited, 1=Last day, 7=Last week, 180=Last half year", "default": "0" }, "filter_duration": { "type": "string", "title": "Filter Duration", "description": "Video duration filter: 0=Unlimited, 0-1=Within 1 minute, 1-5=1 to 5 minutes, 5-10000=More than 5 minutes", "default": "0" }, "content_type": { "type": "string", "title": "Content Type", "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", "default": "0" }, "search_id": { "type": "string", "title": "Search Id", "description": "Search ID for pagination, obtained from the last response", "default": "" }, "backtrace": { "type": "string", "title": "Backtrace", "description": "Backtrace for pagination, obtained from the last response", "default": "" } }, "type": "object", "title": "ChallengeSearchV2Request" }, "Manual1Fc51B60A782_ChallengeSuggestRequest": { "properties": { "keyword": { "type": "string", "title": "Keyword", "description": "Keyword, e.g., 'game'", "default": "游戏" } }, "type": "object", "title": "ChallengeSuggestRequest" }, "Manual1Fc51B60A782_DiscussSearchRequest": { "properties": { "keyword": { "type": "string", "title": "Keyword", "description": "Keyword", "default": "猫咪" }, "cursor": { "type": "integer", "title": "Cursor", "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)", "default": 0 }, "sort_type": { "type": "string", "title": "Sort Type", "description": "Sort type: 0=Comprehensive, 1=Most Likes, 2=Latest\n\nUsage: Sorting method\n - `0`: Comprehensive\n - `1`: Most likes\n - `2`: Latest", "default": "0" }, "publish_time": { "type": "string", "title": "Publish Time", "description": "Publish time filter: 0=Unlimited, 1=Last day, 7=Last week, 180=Last half year", "default": "0" }, "filter_duration": { "type": "string", "title": "Filter Duration", "description": "Video duration filter: 0=Unlimited, 0-1=Within 1 minute, 1-5=1 to 5 minutes, 5-10000=More than 5 minutes", "default": "0" }, "content_type": { "type": "string", "title": "Content Type", "description": "Content type: 0=All, 1=Video, 2=Picture, 3=Article\n\nUsage: Content type filter\n - `0`: Unlimited\n - `1`: Video\n - `2`: Picture\n - `3`: Article", "default": "0" }, "search_id": { "type": "string", "title": "Search Id", "description": "Search ID for pagination, obtained from the last response", "default": "" }, "backtrace": { "type": "string", "title": "Backtrace", "description": "Backtrace for pagination, obtained from the last response", "default": "" } }, "type": "object", "title": "DiscussSearchRequest" }, "Manual1Fc51B60A782_ExperienceSearchRequest": { "properties": { "keyword": { "type": "string", "title": "Keyword", "description": "Keyword", "default": "猫咪" }, "cursor": { "type": "integer", "title": "Cursor", "description": "Offset cursor for pagination, obtained from the last response\n\nUsage: Pagination cursor (0 for first page)", "default": 0 }, "sort_type": { "type": "string", "title": "Sort Type", "description": "Sort type: 0=Comprehensive, 1=Most Likes, 2=Latest\n\nUsage: Sorting method\n - `0`: Comprehensive\n - `1`: Most likes\n - `2`: Latest", "default": "0" }, "publish_time": { "type": "string", "title": "Publish Time", "description": "Publish time filter: 0=Unlimited, 1=Last day, 7=Last week, 180=Last half year", "default": "0" }, "filter_duration": { "type": "string", "title": "Filter Duration", "description": "Video duration filter: 0=Unlimited, 0-1=Within 1 minute, 1-5=1 to 5 minutes, 5-10000=More than 5 minutes", "default": "0" }, "content_type": { "type": "string", "title": "Content Type", "description": "Content type: 0=All, 1=Video, 2=Picture, 3=Article", "default": "0" }, "search_id": { "type": "string", "title": "Search Id", "description": "Search ID for pagination, obtained from the last response", "default": "" }, "backtrace": { "type": "string", "title": "Backtrace", "description": "Backtrace for pagination, obtained from the last response", "default": "" } }, "type": "object", "title": "ExperienceSearchRequest" }, "Manual1Fc51B60A782_GeneralSearchV3Request": { "properties": { "keyword": { "type": "string", "title": "Keyword", "description": "Search keyword", "default": "猫咪" }, "offset": { "type": "integer", "title": "Offset", "description": "Offset cursor for pagination, obtained from data.pagination.offset of the last response, 0 for the first request", "default": 0 }, "page": { "type": "integer", "title": "Page", "description": "Page number, 1-200, start with 1 and increment by 1 each time", "default": 1 }, "search_id": { "type": "string", "title": "Search Id", "description": "Search ID, obtained from data.pagination.search_id of the last response, empty for the first request", "default": "" }, "backtrace": { "type": "string", "title": "Backtrace", "description": "Backtrace, obtained from data.pagination.backtrace of the last response, empty for the first request", "default": "" } }, "type": "object", "title": "GeneralSearchV3Request" }, "Manual1Fc51B60A782_ImageSearchV3Request": { "properties": { "keyword": { "type": "string", "title": "Keyword", "description": "Search keyword" }, "cursor": { "type": "integer", "title": "Cursor", "description": "Pagination cursor (0 for the first request)", "default": 0 }, "search_id": { "type": "string", "title": "Search Id", "description": "Search ID for pagination", "default": "" } }, "type": "object", "required": [ "keyword" ], "title": "ImageSearchV3Request" }, "Manual1Fc51B60A782_LiveSearchV2Request": { "properties": { "keyword": { "type": "string", "title": "Keyword", "description": "Douyin ID or nickname", "default": "小耳朵" }, "cursor": { "type": "integer", "title": "Cursor", "description": "Pagination cursor, 0 for the first request, then the cursor from the last response", "default": 0 } }, "type": "object", "title": "LiveSearchV2Request" }, "Manual1Fc51B60A782_MultiSearchRequest": { "properties": { "keyword": { "type": "string", "title": "Keyword", "description": "Keyword", "default": "猫咪" }, "cursor": { "type": "integer", "title": "Cursor", "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)", "default": 0 }, "sort_type": { "type": "string", "title": "Sort Type", "description": "Sort type: 0=Comprehensive, 1=Most Likes, 2=Latest\n\nUsage: Sorting method\n - `0`: Comprehensive\n - `1`: Most likes\n - `2`: Latest", "default": "0" }, "publish_time": { "type": "string", "title": "Publish Time", "description": "Publish time filter: 0=Unlimited, 1=Last day, 7=Last week, 180=Last half year", "default": "0" }, "filter_duration": { "type": "string", "title": "Filter Duration", "description": "Video duration filter: 0=Unlimited, 0-1=Within 1 minute, 1-5=1 to 5 minutes, 5-10000=More than 5 minutes", "default": "0" }, "content_type": { "type": "string", "title": "Content Type", "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", "default": "0" }, "search_id": { "type": "string", "title": "Search Id", "description": "Search ID for pagination, obtained from the last response", "default": "" }, "backtrace": { "type": "string", "title": "Backtrace", "description": "Backtrace for pagination, obtained from the last response", "default": "" } }, "type": "object", "title": "MultiSearchRequest" }, "Manual1Fc51B60A782_MusicSearchRequest": { "properties": { "keyword": { "type": "string", "title": "Keyword", "description": "Keyword", "default": "猫咪" }, "cursor": { "type": "integer", "title": "Cursor", "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)", "default": 0 }, "sort_type": { "type": "string", "title": "Sort Type", "description": "Sort type: 0=Comprehensive, 1=Most Likes, 2=Latest\n\nUsage: Sorting method\n - `0`: Comprehensive\n - `1`: Most likes\n - `2`: Latest", "default": "0" }, "publish_time": { "type": "string", "title": "Publish Time", "description": "Publish time filter: 0=Unlimited, 1=Last day, 7=Last week, 180=Last half year", "default": "0" }, "filter_duration": { "type": "string", "title": "Filter Duration", "description": "Video duration filter: 0=Unlimited, 0-1=Within 1 minute, 1-5=1 to 5 minutes, 5-10000=More than 5 minutes", "default": "0" }, "content_type": { "type": "string", "title": "Content Type", "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", "default": "0" }, "search_id": { "type": "string", "title": "Search Id", "description": "Search ID for pagination, obtained from the last response", "default": "" }, "backtrace": { "type": "string", "title": "Backtrace", "description": "Backtrace for pagination, obtained from the last response", "default": "" } }, "type": "object", "title": "MusicSearchRequest" }, "Manual1Fc51B60A782_SchoolSearchRequest": { "properties": { "keyword": { "type": "string", "title": "Keyword", "description": "Keyword, such as school name or location", "default": "北京" } }, "type": "object", "title": "SchoolSearchRequest" }, "Manual1Fc51B60A782_SearchSuggestRequest": { "properties": { "keyword": { "type": "string", "title": "Keyword", "description": "The keyword to be suggested", "default": "人工智能" } }, "type": "object", "title": "SearchSuggestRequest" }, "Manual1Fc51B60A782_UserSearchRequestV2": { "properties": { "keyword": { "type": "string", "title": "Keyword", "description": "Keyword", "default": "猫咪" }, "cursor": { "type": "integer", "title": "Cursor", "description": "Offset cursor for pagination, obtained from the last response", "default": 0 } }, "type": "object", "title": "UserSearchRequestV2" }, "Manual1Fc51B60A782_VideoSearchV5Request": { "properties": { "keyword": { "type": "string", "title": "Keyword", "description": "Search keyword", "default": "猫咪" }, "offset": { "type": "integer", "title": "Offset", "description": "Offset cursor for pagination, obtained from data.pagination.offset of the last response, 0 for the first request", "default": 0 }, "page": { "type": "integer", "title": "Page", "description": "Page number, 1-200, start with 1 and increment by 1 each time", "default": 1 }, "search_id": { "type": "string", "title": "Search Id", "description": "Search ID, obtained from data.pagination.search_id of the last response, empty for the first request", "default": "" }, "backtrace": { "type": "string", "title": "Backtrace", "description": "Backtrace, obtained from data.pagination.backtrace of the last response, empty for the first request", "default": "" } }, "type": "object", "title": "VideoSearchV5Request" }, "Manual1Fc51B60A782_ChallengePostRequest": { "properties": { "challenge_id": { "type": "string", "title": "Challenge Id", "description": "Challenge ID", "default": "1608846127610893" }, "sort_type": { "type": "integer", "title": "Sort Type", "description": "Sort type\n - 0: Comprehensive sorting 1: Hottest sorting 2: Latest sorting", "default": 0 }, "cursor": { "type": "integer", "title": "Cursor", "description": "Cursor", "default": 0 }, "count": { "type": "integer", "title": "Count", "description": "Count", "default": 20 }, "cookie": { "type": "string", "title": "Cookie", "description": "User provided Cookie", "default": "" } }, "type": "object", "title": "ChallengePostRequest" }, "Manual1Fc51B60A782_Body_fetch_home_feed_api_v1_douyin_web_fetch_home_feed_post": { "properties": { "count": { "type": "integer", "title": "Count", "description": "Number, default is 10, it is recommended to keep it unchanged.", "default": 10 }, "refresh_index": { "type": "integer", "title": "Refresh Index", "description": "Refresh-paging index: 0=refresh (first page / pull-down), >0=load-more (scroll down), increment by 1 for next page\n\nUsage: Refresh/paging index, start at 0 and +1 per page.\n - refresh_index=0: refresh (first entry / pull-to-refresh)\n - refresh_index>0: load-more (scroll down)", "default": 0 }, "cookie": { "type": "string", "title": "Cookie", "description": "Optional: Your web Douyin login Cookie for a personalized feed; uses the default Cookie if omitted", "default": "" } }, "type": "object", "title": "Body_fetch_home_feed_api_v1_douyin_web_fetch_home_feed_post" }, "Manual1Fc51B60A782_Body_fetch_user_collection_videos_api_v1_douyin_web_fetch_user_collection_videos_post": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "Your web version of Douyin Cookie\n\nUsage: User's web version of Douyin Cookie (This interface requires users to provide their own Cookie)" }, "max_cursor": { "type": "integer", "title": "Max Cursor", "description": "Maximum cursor", "default": 0 }, "counts": { "type": "integer", "title": "Counts", "description": "Number per page", "default": 20 } }, "type": "object", "required": [ "cookie" ], "title": "Body_fetch_user_collection_videos_api_v1_douyin_web_fetch_user_collection_videos_post" }, "Manual1Fc51B60A782_Body_fetch_user_collects_api_v1_douyin_web_fetch_user_collects_post": { "properties": { "max_cursor": { "type": "integer", "title": "Max Cursor", "description": "Maximum cursor", "default": 0 }, "counts": { "type": "integer", "title": "Counts", "description": "Number per page", "default": 20 }, "cookie": { "type": "string", "title": "Cookie", "description": "Your web version of Douyin Cookie\n\nUsage: User's web version of Douyin Cookie (This interface requires users to provide their own Cookie)" } }, "type": "object", "required": [ "cookie" ], "title": "Body_fetch_user_collects_api_v1_douyin_web_fetch_user_collects_post" }, "Manual1Fc51B60A782_Body_fetch_user_like_videos_api_v1_douyin_web_fetch_user_like_videos_post": { "properties": { "sec_user_id": { "type": "string", "title": "Sec User Id", "description": "User sec_user_id" }, "max_cursor": { "type": "integer", "title": "Max Cursor", "description": "Maximum cursor", "default": 0 }, "counts": { "type": "integer", "title": "Counts", "description": "Number per page", "default": 20 }, "cookie": { "type": "string", "title": "Cookie", "description": "Your web version of Douyin Cookie\n\nUsage: User's web version of Douyin Cookie (This interface requires users to provide their own Cookie)" } }, "type": "object", "required": [ "sec_user_id" ], "title": "Body_fetch_user_like_videos_api_v1_douyin_web_fetch_user_like_videos_post" }, "Manual1Fc51B60A782_Body_get_ip_activity_list_api_v1_douyin_xingtu_v2_get_ip_activity_list_post": { "properties": { "query_start_time": { "type": "string", "title": "Query Start Time", "description": "Query start timestamp, e.g. `1767196800`" }, "query_end_time": { "type": "string", "title": "Query End Time", "description": "Query end timestamp, e.g. `1774972799`" }, "industry_id_list": { "title": "Industry Id List", "description": "Industry ID list", "items": { "type": "string" }, "type": [ "array", "null" ] }, "category_list": { "title": "Category List", "description": "IP category list", "items": { "type": "integer" }, "type": [ "array", "null" ] }, "status_list": { "title": "Status List", "description": "IP status list", "items": { "type": "integer" }, "type": [ "array", "null" ] } }, "type": "object", "required": [ "query_start_time", "query_end_time" ], "title": "Body_get_ip_activity_list_api_v1_douyin_xingtu_v2_get_ip_activity_list_post" }, "Manual1Fc51B60A782_Body_get_item_report_comments_api_v1_douyin_xingtu_v2_get_item_report_comments_post": { "properties": { "item_id": { "type": "string", "title": "Item Id", "description": "Video (item) ID" } }, "type": "object", "required": [ "item_id" ], "title": "Body_get_item_report_comments_api_v1_douyin_xingtu_v2_get_item_report_comments_post" }, "Manual1Fc51B60A782_Body_get_item_report_detail_api_v1_douyin_xingtu_v2_get_item_report_detail_post": { "properties": { "item_id": { "type": "string", "title": "Item Id", "description": "Video (item) ID" } }, "type": "object", "required": [ "item_id" ], "title": "Body_get_item_report_detail_api_v1_douyin_xingtu_v2_get_item_report_detail_post" }, "Manual1Fc51B60A782_Body_get_item_report_th_analysis_api_v1_douyin_xingtu_v2_get_item_report_th_analysis_post": { "properties": { "item_id": { "type": "string", "title": "Item Id", "description": "Video (item) ID" } }, "type": "object", "required": [ "item_id" ], "title": "Body_get_item_report_th_analysis_api_v1_douyin_xingtu_v2_get_item_report_th_analysis_post" }, "Manual1Fc51B60A782_Body_get_item_report_trend_api_v1_douyin_xingtu_v2_get_item_report_trend_post": { "properties": { "item_id": { "type": "string", "title": "Item Id", "description": "Video (item) ID" } }, "type": "object", "required": [ "item_id" ], "title": "Body_get_item_report_trend_api_v1_douyin_xingtu_v2_get_item_report_trend_post" }, "Manual1Fc51B60A782_Body_get_recommend_for_star_authors_api_v1_douyin_xingtu_v2_get_recommend_for_star_authors_post": { "properties": { "author_ids": { "items": { "type": "string" }, "type": "array", "title": "Author Ids", "description": "List of creator author IDs" }, "similar_type": { "type": "string", "title": "Similar Type", "description": "Similarity type\n - `comprehension`: Comprehensive similarity\n - `content`: Content similarity\n - `audience`: Audience similarity\n - `commercial`: Commercial capability similarity", "default": "content" }, "page": { "type": "integer", "title": "Page", "description": "Page number, default 1", "default": 1 } }, "type": "object", "required": [ "author_ids" ], "title": "Body_get_recommend_for_star_authors_api_v1_douyin_xingtu_v2_get_recommend_for_star_authors_post" }, "Manual1Fc51B60A782_Body_multi_get_author_info_api_v1_douyin_xingtu_v2_multi_get_author_info_post": { "properties": { "author_ids": { "items": { "type": "string" }, "type": "array", "title": "Author Ids", "description": "Creator ID list, up to 50 per call", "maxItems": 50 }, "platform_source": { "type": "integer", "title": "Platform Source", "description": "Platform source, default 1", "default": 1 }, "platform_channel": { "type": "integer", "title": "Platform Channel", "description": "Platform channel, default 1", "default": 1 } }, "type": "object", "required": [ "author_ids" ], "title": "Body_multi_get_author_info_api_v1_douyin_xingtu_v2_multi_get_author_info_post" }, "Manual1Fc51B60A782_Body_multi_get_item_stats_api_v1_douyin_xingtu_v2_multi_get_item_stats_post": { "properties": { "item_ids": { "items": { "type": "string" }, "type": "array", "title": "Item Ids", "description": "Video (item) ID list, up to 20 per call (exceeding returns an error); auto de-dup", "maxItems": 20 }, "platform_source": { "type": "integer", "title": "Platform Source", "description": "Platform source, default 1", "default": 1 }, "need_cover_url": { "type": "boolean", "title": "Need Cover Url", "description": "Whether to return cover URL", "default": true } }, "type": "object", "required": [ "item_ids" ], "title": "Body_multi_get_item_stats_api_v1_douyin_xingtu_v2_multi_get_item_stats_post" }, "Manual1Fc51B60A782_XingtuCreatorSearchType": { "type": "integer", "enum": [ 2, 3 ], "title": "XingtuCreatorSearchType" }, "Manual1Fc51B60A782_XingtuContentSearchTimeRange": { "type": "integer", "enum": [ 30, 90, 180 ], "title": "XingtuContentSearchTimeRange" }, "Manual1Fc51B60A782_Body_get_ad_interactive_analysis_api_v1_tiktok_ads_get_ad_interactive_analysis_post": { "properties": { "material_id": { "type": "string", "title": "Material Id", "description": "Ad material ID" }, "metric_type": { "type": "string", "title": "Metric Type", "description": "Analysis type\n - ctr: Click-through rate analysis\n - cvr: Conversion rate analysis\n - clicks: Click count analysis\n - conversion: Conversion count analysis\n - remain: Retention rate analysis (default)", "default": "remain" }, "period_type": { "type": "integer", "title": "Period Type", "description": "Period type (days)\n\nUsage: Time range, default 180 days", "default": 180 }, "cookie": { "type": "string", "title": "Cookie", "description": "Custom Cookie string, optional parameter, can be used to fetch more data" } }, "type": "object", "required": [ "material_id" ], "title": "Body_get_ad_interactive_analysis_api_v1_tiktok_ads_get_ad_interactive_analysis_post" }, "Manual1Fc51B60A782_Body_get_ad_keyframe_analysis_api_v1_tiktok_ads_get_ad_keyframe_analysis_post": { "properties": { "material_id": { "type": "string", "title": "Material Id", "description": "Ad material ID" }, "metric": { "type": "string", "title": "Metric", "description": "Analysis metric, options:\n - retain_ctr: Retention CTR (default)\n - retain_cvr: Retention CVR\n - click_cnt: Click count\n - convert_cnt: Conversion count\n - play_retain_cnt: Play retention count", "default": "retain_ctr" }, "cookie": { "type": "string", "title": "Cookie", "description": "Custom Cookie string, optional parameter, can be used to fetch more data" } }, "type": "object", "required": [ "material_id" ], "title": "Body_get_ad_keyframe_analysis_api_v1_tiktok_ads_get_ad_keyframe_analysis_post" }, "Manual1Fc51B60A782_Body_get_ad_percentile_api_v1_tiktok_ads_get_ad_percentile_post": { "properties": { "material_id": { "type": "string", "title": "Material Id", "description": "Ad material ID" }, "metric": { "type": "string", "title": "Metric", "description": "Analysis metric, options:\n - ctr_percentile: CTR percentile (default)\n - time_attr_conversion_rate_percentile: Time-attributed conversion rate percentile\n - click_cnt_percentile: Click count percentile\n - time_attr_convert_cnt_percentile: Time-attributed conversion count percentile\n - show_cnt_percentile: Impression count percentile", "default": "ctr_percentile" }, "period_type": { "type": "integer", "title": "Period Type", "description": "Time period in days, default 180", "default": 180 }, "cookie": { "type": "string", "title": "Cookie", "description": "Custom Cookie string, optional parameter, can be used to fetch more data" } }, "type": "object", "required": [ "material_id" ], "title": "Body_get_ad_percentile_api_v1_tiktok_ads_get_ad_percentile_post" }, "Manual1Fc51B60A782_Body_get_ads_detail_api_v1_tiktok_ads_get_ads_detail_post": { "properties": { "ads_id": { "type": "string", "title": "Ads Id", "description": "Ad ID, required parameter, can be obtained from ad lists or TikTok Ads Creative Center" }, "cookie": { "type": "string", "title": "Cookie", "description": "Custom Cookie string, optional parameter, can be used to fetch more data" } }, "type": "object", "required": [ "ads_id" ], "title": "Body_get_ads_detail_api_v1_tiktok_ads_get_ads_detail_post" }, "Manual1Fc51B60A782_Body_get_creators_card_api_v1_tiktok_ads_get_creators_card_post": { "properties": { "tt_uids": { "items": { "type": "string" }, "type": "array", "title": "Tt Uids", "description": "Creator ID list, obtained from `itemInfo.creatorID` of /tikhub/tiktok/ads/get_top_contents_list, multiple IDs allowed\n\nAPI references: `get_top_contents_list` = `POST /tikhub/tiktok/ads/get_top_contents_list` (operationId: `post_tikhub_tiktok_ads_get_top_contents_list`).", "default": [ "103641138313531392" ] }, "need_loader_list": { "items": { "type": "integer" }, "type": "array", "title": "Need Loader List", "description": "Data module IDs, empty for all\n\nUsage: Data module IDs to return, omit for all. Options:\n - `101`: Creator basic info\n - `102`: Quote and price index\n - `103`: Creator basic info\n - `104`: Statistics (audience profile / follower trend / overall performance / video performance)\n - `105`: Recent posts\n - `106`: Creator marketplace status\n - `107`: Content labels\n - `125`: Creator type and display info", "example": [ 101, 102, 103, 104, 105, 106, 107, 125 ] }, "creator_type": { "type": "integer", "title": "Creator Type", "description": "Creator type, default 2", "default": 2 }, "cookie": { "type": "string", "title": "Cookie", "description": "Custom Cookie string, optional parameter, you can use your own Cookie to get more data" } }, "type": "object", "title": "Body_get_creators_card_api_v1_tiktok_ads_get_creators_card_post" }, "Manual1Fc51B60A782_Body_get_query_suggestions_api_v1_tiktok_ads_get_query_suggestions_post": { "properties": { "query": { "type": "string", "title": "Query", "description": "Leave empty for scenario 1 (popular suggestions); input a keyword for scenario 2\n\nUsage: Leave empty for popular suggestions in scenario 1; provide a keyword for related suggestions in scenario 2" }, "count": { "type": "integer", "title": "Count", "description": "Suggestion count\n\nUsage: Number of suggestions to return, default 50", "default": 50 }, "scenario": { "type": "integer", "title": "Scenario", "description": "Scene type: 1=Popular suggestions, 2=Related keyword suggestions", "default": 1 }, "country_code": { "type": "string", "title": "Country Code", "description": "Optional country/region code" }, "cookie": { "type": "string", "title": "Cookie", "description": "Custom Cookie string, optional parameter, can be used to fetch more data" } }, "type": "object", "title": "Body_get_query_suggestions_api_v1_tiktok_ads_get_query_suggestions_post" }, "Manual1Fc51B60A782_Body_get_recommended_ads_api_v1_tiktok_ads_get_recommended_ads_post": { "properties": { "material_id": { "type": "string", "title": "Material Id", "description": "Reference ad material ID, required parameter" }, "industry": { "type": "string", "title": "Industry", "description": "Industry ID, e.g., Games: 25308000000", "default": "25308000000" }, "country_code": { "type": "string", "title": "Country Code", "description": "Country code", "default": "US" }, "cookie": { "type": "string", "title": "Cookie", "description": "Custom Cookie string, optional parameter, can be used to fetch more data" } }, "type": "object", "required": [ "material_id" ], "title": "Body_get_recommended_ads_api_v1_tiktok_ads_get_recommended_ads_post" }, "Manual1Fc51B60A782_Body_get_top_ads_spotlight_api_v1_tiktok_ads_get_top_ads_spotlight_post": { "properties": { "industry": { "type": "string", "title": "Industry", "description": "Industry ID, optional, returns cross-industry list if omitted, e.g., Education: 25000000000" }, "page": { "type": "integer", "title": "Page", "description": "Page number, default 1", "default": 1 }, "limit": { "type": "integer", "title": "Limit", "description": "Items per page, default 20", "default": 20 }, "cookie": { "type": "string", "title": "Cookie", "description": "Custom Cookie string, optional parameter, can be used to fetch more data" } }, "type": "object", "title": "Body_get_top_ads_spotlight_api_v1_tiktok_ads_get_top_ads_spotlight_post" }, "Manual1Fc51B60A782_Body_get_top_contents_item_detail_api_v1_tiktok_ads_get_top_contents_item_detail_post": { "properties": { "item_id": { "type": "string", "title": "Item Id", "description": "Video item ID\n\nUsage: Video ID, obtained from `itemInfo.itemID` of /tikhub/tiktok/ads/get_top_contents_list\n\nAPI references: `get_top_contents_list` = `POST /tikhub/tiktok/ads/get_top_contents_list` (operationId: `post_tikhub_tiktok_ads_get_top_contents_list`)." }, "period_end_timestamp": { "type": "integer", "title": "Period End Timestamp", "description": "The caller must generate this 10-digit Unix timestamp in seconds from the target ranking date, for example 1785024000; do not pass 0 because it returns an empty result\n\nUsage: Period end timestamp in seconds, required\n - Generate this value from the target ranking date; it is not returned by another endpoint\n - Example: `1785024000`; do not pass `0`, which returns an empty result\n - For period_dimension 1, pass a Sunday 00:00 UTC timestamp; other dates return no data\n - For period_dimension 3 or 5, any past date works\n - If item_id comes from /tikhub/tiktok/ads/get_top_contents_list, reuse that ranking query's timestamp\n\nAPI references: `get_top_contents_list` = `POST /tikhub/tiktok/ads/get_top_contents_list` (operationId: `post_tikhub_tiktok_ads_get_top_contents_list`).", "example": 1785024000 }, "period_dimension": { "type": "integer", "title": "Period Dimension", "description": "Period dimension: 1/3/5\n\nUsage: Period, one of 1 / 3 / 5, default 3, recommended to match the ranking query", "default": 3, "example": 1 }, "country_code": { "type": "string", "title": "Country Code", "description": "Country code of the ranking the video belongs to, default US", "default": "US" }, "cookie": { "type": "string", "title": "Cookie", "description": "Custom Cookie string, optional parameter, you can use your own Cookie to get more data" } }, "type": "object", "required": [ "item_id", "period_end_timestamp" ], "title": "Body_get_top_contents_item_detail_api_v1_tiktok_ads_get_top_contents_item_detail_post" }, "Manual1Fc51B60A782_Body_get_top_contents_list_api_v1_tiktok_ads_get_top_contents_list_post": { "properties": { "period_end_timestamp": { "type": "integer", "title": "Period End Timestamp", "description": "The caller must generate this 10-digit Unix timestamp in seconds from the target ranking date, for example 1785024000; do not pass 0 because it returns an empty result\n\nUsage: Period end timestamp in seconds, required\n - Generate this value from the target ranking date; it is not returned by another endpoint\n - Example: `1785024000`; do not pass `0`, which returns an empty result\n - For period_dimension 1, pass a Sunday 00:00 UTC timestamp; other dates return no data\n - For period_dimension 3 or 5, any past date works", "example": 1785024000 }, "period_dimension": { "type": "integer", "title": "Period Dimension", "description": "Period dimension: 1/3/5\n\nUsage: Period, default 3\n - `1`: Weekly ranking\n - `3`: Daily ranking\n - `5`: Long-period ranking (covers videos over a longer time span)", "default": 3, "example": 1 }, "country_code": { "type": "string", "title": "Country Code", "description": "Country/region code\n\nUsage: Country code, default US, see /tikhub/tiktok/ads/get_location_list for options\n\nAPI references: `get_location_list` = `POST /tikhub/tiktok/ads/get_location_list` (operationId: `post_tikhub_tiktok_ads_get_location_list`).", "default": "US" }, "content_label_ids": { "type": "string", "title": "Content Label Ids", "description": "Content label IDs, comma separated (e.g. `11002,11015`), empty for all. Options:\n - `11001`: Nature & Animals\n - `11002`: Beauty & Care\n - `11003`: Fashion\n - `11004`: Music & Entertainment\n - `11005`: Games\n - `11006`: Education & Work\n - `11007`: Sports & Outdoor\n - `11008`: Creativity & Talent\n - `11009`: Family & Relationship\n - `11010`: Food & Beverage\n - `11011`: Vlog & Selfie\n - `11012`: Society\n - `11013`: Lifestyle & Leisure\n - `11014`: Vehicles & Transportation\n - `11015`: Technology & Finance", "default": "" }, "order_by_metric": { "type": "integer", "title": "Order By Metric", "description": "Order by metric: 1=Views, 2=Engagement rate, 3=6-second completion rate\n\nUsage: Sorting metric, default 1\n - `1`: By video views\n - `2`: By engagement rate\n - `3`: By 6-second view-through rate", "default": 1, "example": 1 }, "organic_only": { "type": "boolean", "title": "Organic Only", "description": "Organic content only", "default": false }, "page": { "type": "integer", "title": "Page", "description": "Page number, default 1", "default": 1 }, "limit": { "type": "integer", "title": "Limit", "description": "Items per page, default 20, max 100", "default": 20, "maximum": 100 }, "cookie": { "type": "string", "title": "Cookie", "description": "Custom Cookie string, optional parameter, you can use your own Cookie to get more data" } }, "type": "object", "required": [ "period_end_timestamp" ], "title": "Body_get_top_contents_list_api_v1_tiktok_ads_get_top_contents_list_post" }, "Manual1Fc51B60A782_Body_get_trends_hashtag_detail_api_v1_tiktok_ads_get_trends_hashtag_detail_post": { "properties": { "hashtag_id": { "type": "string", "title": "Hashtag Id", "description": "Hashtag ID, obtained from /tikhub/tiktok/ads/get_trends_hashtag_list\n\nAPI references: `get_trends_hashtag_list` = `POST /tikhub/tiktok/ads/get_trends_hashtag_list` (operationId: `post_tikhub_tiktok_ads_get_trends_hashtag_list`)." }, "time_range": { "type": "integer", "title": "Time Range", "description": "Time range in days, one of 7 / 30 / 90, default 90 (must match the hashtag's ranking range or data will be empty)", "default": 90 }, "country_code": { "type": "string", "title": "Country Code", "description": "Country/region code", "default": "US" }, "cookie": { "type": "string", "title": "Cookie", "description": "Custom Cookie string, optional parameter, you can use your own Cookie to get more data" } }, "type": "object", "required": [ "hashtag_id" ], "title": "Body_get_trends_hashtag_detail_api_v1_tiktok_ads_get_trends_hashtag_detail_post" }, "Manual1Fc51B60A782_Body_get_trends_hashtag_list_api_v1_tiktok_ads_get_trends_hashtag_list_post": { "properties": { "time_range": { "type": "integer", "title": "Time Range", "description": "Time range in days, one of 7 / 30 / 90, default 7", "default": 7 }, "country_code": { "type": "string", "title": "Country Code", "description": "Country/region code\n\nUsage: Country code, default US (see /tikhub/tiktok/ads/get_location_list for options)\n\nAPI references: `get_location_list` = `POST /tikhub/tiktok/ads/get_location_list` (operationId: `post_tikhub_tiktok_ads_get_location_list`).", "default": "US" }, "page": { "type": "integer", "title": "Page", "description": "Page number, default 1", "default": 1 }, "limit": { "type": "integer", "title": "Limit", "description": "Items per page, default 20", "default": 20 }, "industry_id": { "type": "integer", "title": "Industry Id", "description": "First-level industry ID (optional), e.g. 10000000000=Education\n\nUsage: First-level industry ID (optional), filters hashtags by industry; omit for all industries. Options:\n - 10000000000: Education\n - 11000000000: Vehicle & Transportation\n - 12000000000: Baby, Kids & Maternity\n - 13000000000: Financial Services\n - 14000000000: Beauty & Personal Care\n - 15000000000: Tech & Electronics\n - 16000000000: Appliances\n - 17000000000: Travel\n - 18000000000: Household Products\n - 19000000000: Pets\n - 20000000000: Apps\n - 21000000000: Home Improvement\n - 22000000000: Apparel & Accessories\n - 23000000000: News & Entertainment\n - 24000000000: Business Services\n - 25000000000: Games\n - 26000000000: Life Services\n - 27000000000: Food & Beverage\n - 28000000000: Sports & Outdoor\n - 29000000000: Health" }, "cookie": { "type": "string", "title": "Cookie", "description": "Custom Cookie string, optional parameter, you can use your own Cookie to get more data" } }, "type": "object", "title": "Body_get_trends_hashtag_list_api_v1_tiktok_ads_get_trends_hashtag_list_post" }, "Manual1Fc51B60A782_Body_search_ads_api_v1_tiktok_ads_search_ads_post": { "properties": { "objective": { "title": "Objective", "description": "Ad objective (optional): 1=Traffic, 2=App install, 3=Conversion, 4=Video views, 5=Reach, 6=Lead generation, 7=Product sales", "type": [ "integer", "null" ] }, "like": { "title": "Like", "description": "Performance rank (optional; 1=top 1-20%, 2=top 21-40%, 3=top 41-60%, 4=top 61-80%, 5=top 81-100%)", "type": [ "integer", "null" ] }, "period": { "type": "integer", "title": "Period", "description": "Time period in days, e.g., 7, 30, 120, 180 days", "default": 180 }, "industry": { "type": "string", "title": "Industry", "description": "Industry ID list, multiple IDs separated by commas. Full industry ID list: https://github.com/TikHub/TikTok-Ads-Industry-Code" }, "keyword": { "type": "string", "title": "Keyword", "description": "Search keyword, optional, returns all ads if empty" }, "page": { "type": "integer", "title": "Page", "description": "Page number, default 1", "default": 1 }, "limit": { "type": "integer", "title": "Limit", "description": "Items per page, default 20, max 50", "default": 20, "maximum": 50 }, "order_by": { "type": "string", "title": "Order By", "description": "Sort method, \"for_you\"=Recommended, \"likes\"=Sort by likes", "default": "for_you" }, "country_code": { "type": "string", "title": "Country Code", "description": "Country code", "default": "US" }, "ad_format": { "title": "Ad Format", "description": "Ad format (optional): 1=Spark Ads, 2=Non-Spark Ads", "type": [ "integer", "null" ] }, "ad_language": { "title": "Ad Language", "description": "Ad language (optional)", "type": [ "string", "null" ] }, "duration": { "title": "Duration", "description": "Video duration filter value (optional)", "type": [ "integer", "null" ] }, "pattern_label": { "title": "Pattern Label", "description": "Creative pattern label (optional)", "type": [ "string", "null" ] }, "search_id": { "type": "string", "title": "Search Id", "description": "Search ID (optional)" }, "cookie": { "type": "string", "title": "Cookie", "description": "Custom Cookie string, optional parameter, can be used to fetch more data" } }, "type": "object", "title": "Body_search_ads_api_v1_tiktok_ads_search_ads_post" }, "Manual1Fc51B60A782_TikTok_APP_Encrypt_Request": { "properties": { "url": { "type": "string", "title": "Url", "description": "URL to be encrypted", "default": "https://api16-normal-useast5.tiktokv.us/tiktok/v1/upvote/item/list?user_id=6726034365602628610&offset=0&count=21&scene=0&iid=7425045478163400491&device_id=7349721034012280362&ac=WIFI&channel=googleplay&aid=1233&app_name=musical_ly&version_code=360704&version_name=36.7.4&device_platform=android&os=android&ab_version=36.7.4&ssmix=a&device_type=Pixel+6+Pro&device_brand=google&language=zh&os_api=33&os_version=13&openudid=711192517a8bbf03&manifest_version_code=2023607040&resolution=1440*2891&dpi=560&update_version_code=2023607040&_rticket=1728977220468&is_pad=0&app_type=normal&sys_region=CN&last_install_time=1728977141&timezone_name=America%2FLos_Angeles&app_language=zh-Hans&ac2=wifi5g&uoo=0&op_region=CN&timezone_offset=-28800&build_number=36.7.4&host_abi=arm64-v8a&locale=zh-Hans®ion=CN&content_language=en%2C&ts=1728977220&cdid=aa21524b-8633-49ca-8e6e-3275fe1672db" }, "data": { "type": "string", "title": "Data", "description": "If there is a POST request, please fill in the POST request data to participate in the encryption calculation", "default": "" }, "device_info": { "additionalProperties": true, "type": "object", "title": "Device Info", "description": "Device information, optional parameter; if not provided, default device information is used\n\nUsage: Device information, optional parameter, if not filled in, the default device information will be used, and the device information will modify the parameters in the URL passed in.", "default": { "aid": "1233", "cdid": "b820f79c-c74a-47b0-912f-ee3002ce60dc", "channel": "googleplay", "cookies": {}, "device_brand": "HONOR", "device_id": "7423364899755607598", "device_manufacturer": "HUAWEI", "device_model": "HONOR V30", "device_platform": "android", "device_type": "OXF-AN00", "dpi": 480, "host_abi": "arm64-v8a", "iid": "7423365134775469866", "lanusk": "", "manifest_version_code": "2023604040", "mc": "7E:EE:BA:BC:5E:40", "mssdk_token": "", "openudid": "63401ab5140125d1", "os_api": 29, "os_version": "10", "resolution": "2400*1080", "rom": "11.0.0.185C00", "rom_version": "OXF-AN00-user 11.0.0 HUAWEIOXF-AN00 185-CHN-LGRP3 release-keys", "server_time": 1728386909, "ua": "com.zhiliaoapp.musically/2023604040 (Linux; U; Android 10; zh_CN; OXF-AN00; Build/185-CHN-LGRP3;tt-ok/3.12.13.4-tiktok)", "update_version_code": "2023604040", "uuid": "350244698061054", "version_code": "360404", "version_name": "36.4.4" } } }, "type": "object", "title": "TikTok_APP_Encrypt_Request" }, "Manual1Fc51B60A782_LiveRoomBatchCheckRequest": { "properties": { "room_ids": { "items": { "type": "string" }, "type": "array", "title": "Room Ids", "description": "List of TikTok live room IDs", "default": [ "7494491933781003054", "7494514925034113835", "7494520590523517739" ] } }, "type": "object", "title": "LiveRoomBatchCheckRequest" }, "Manual1Fc51B60A782_TikTok_APP_Login_Encrypt_Decrypt_Request": { "properties": { "username": { "type": "string", "title": "Username", "description": "Plaintext or encrypted username", "default": "example_username" }, "password": { "type": "string", "title": "Password", "description": "Plaintext or encrypted password", "default": "example_password" }, "mode": { "description": "Encrypt or decrypt the input string\n\nUsage: Mode\n - `encrypt`: Encrypt\n - `decrypt`: Decrypt", "default": "encrypt", "allOf": [ { "$ref": "#/components/schemas/Manual1Fc51B60A782_ModeEnum" } ] } }, "type": "object", "title": "TikTok_APP_Login_Encrypt_Decrypt_Request", "example": { "mode": "encrypt", "password": "example_password", "username": "example_username" } }, "Manual1Fc51B60A782_ModeEnum": { "type": "string", "enum": [ "encrypt", "decrypt" ], "title": "ModeEnum" }, "Manual1Fc51B60A782_TikTok_APP_V3_Content_Translate": { "properties": { "trg_lang": { "type": "string", "title": "Trg Lang", "description": "Target language ISO639-1 code, e.g. zh-Hans\n\nUsage: Target language\n - zh-Hans: Simplified Chinese\n - zh-Hant: Traditional Chinese\n - en: English\n - ja: Japanese\n - ko: Korean\n - fr: French\n - de: German\n - ru: Russian\n - es: Spanish\n - pt: Portuguese\n - vi: Vietnamese\n - th: Thai\n - id: Indonesian\n - ar: Arabic\n - it: Italian\n - tr: Turkish\n - he: Hebrew\n - pl: Polish\n - nl: Dutch\n - sv: Swedish\n - da: Danish\n - fi: Finnish\n - no: Norwegian\n - cs: Czech\n - hu: Hungarian", "default": "zh-Hans" }, "src_content": { "type": "string", "title": "Src Content", "description": "Source language content, i.e. the content to be translated\n\nUsage: Source content, that is, the content that needs to be translated, the length does not exceed 5000 characters, if it exceeds 5000 characters, only the first 5000 characters will be translated.", "default": "Hello, welcome to TikHub!" } }, "type": "object", "title": "TikTok_APP_V3_Content_Translate" }, "Manual1Fc51B60A782_TikTok_APP_V3_Home_Feed": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User's own cookie, optional parameter, used for personalized recommendations of interface return data.", "default": "" } }, "type": "object", "title": "TikTok_APP_V3_Home_Feed" }, "Manual1Fc51B60A782_GetAccountHealthRequest": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User Cookie String", "default": "Your_Cookie_String" }, "proxy": { "title": "Proxy", "description": "Optional HTTP proxy address, can be omitted if not needed\n - Example format: `http://username:password@host:port`", "default": "", "type": [ "string", "null" ] } }, "type": "object", "title": "GetAccountHealthRequest" }, "Manual1Fc51B60A782_GetAccountOverviewRequest": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User Cookie String", "default": "Your_Cookie_String" }, "proxy": { "title": "Proxy", "description": "Optional HTTP proxy address. Leave empty if not needed.\n - Example format: `http://username:password@host:port`", "default": "", "type": [ "string", "null" ] }, "start_date": { "type": "string", "title": "Start Date", "description": "Query Start Date, e.g. '04-01-2025'", "default": "04-01-2025" } }, "type": "object", "title": "GetAccountOverviewRequest" }, "Manual1Fc51B60A782_GetViolationRecordRequest": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User Cookie String", "default": "Your_Cookie_String" }, "proxy": { "title": "Proxy", "description": "Optional HTTP proxy address, can be omitted if not needed\n - Example format: `http://username:password@host:port`", "default": "", "type": [ "string", "null" ] }, "page": { "type": "integer", "title": "Page", "description": "Integer, page number (default is `1`)", "default": 1 } }, "type": "object", "title": "GetViolationRecordRequest" }, "Manual1Fc51B60A782_GetCreatorAccountInfoRequest": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User Cookie String", "default": "Your_Cookie_String" }, "proxy": { "title": "Proxy", "description": "Optional HTTP proxy address, can be omitted if not used\n - Example format: `http://username:password@host:port`", "default": "", "type": [ "string", "null" ] } }, "type": "object", "title": "GetCreatorAccountInfoRequest" }, "Manual1Fc51B60A782_GetLiveOverviewRequest": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User Cookie String", "default": "Your_Cookie_String" }, "proxy": { "title": "Proxy", "description": "Optional HTTP proxy address, can be omitted if not used\n - Example format: `http://username:password@host:port`", "default": "", "type": [ "string", "null" ] }, "start_date": { "type": "string", "title": "Start Date", "description": "Query start date in the format `MM-DD-YYYY`, e.g., `04-01-2025`", "default": "04-01-2025" } }, "type": "object", "title": "GetLiveOverviewRequest" }, "Manual1Fc51B60A782_GetProductListRequest": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User Cookie String", "default": "Your_Cookie_String" }, "proxy": { "title": "Proxy", "description": "Optional HTTP proxy address, can be omitted if not used\n - Example format: `http://username:password@host:port`", "default": "", "type": [ "string", "null" ] }, "start_date": { "type": "string", "title": "Start Date", "description": "Start date, e.g. '2025-04-01'", "default": "2025-04-01" }, "end_date": { "type": "string", "title": "End Date", "description": "End Date, e.g. '2025-05-01'", "default": "2025-05-01" }, "page": { "type": "integer", "title": "Page", "description": "Page number, default is the first page `0`", "default": 0 } }, "type": "object", "title": "GetProductListRequest" }, "Manual1Fc51B60A782_GetProductRelatedVideosRequest": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User Cookie String", "default": "Your_Cookie_String" }, "proxy": { "title": "Proxy", "description": "Optional HTTP proxy address, can be omitted if not used\n - Example format: `http://username:password@host:port`", "default": "", "type": [ "string", "null" ] }, "start_date": { "type": "string", "title": "Start Date", "description": "Query Start Date, e.g. '04-01-2025'", "default": "04-01-2025" }, "item_id": { "type": "string", "title": "Item Id", "description": "Current video ID, for example \"7496499484705246507\"." }, "product_id": { "type": "string", "title": "Product Id", "description": "Product ID, for example \"1731050202505515549\"." } }, "type": "object", "required": [ "item_id", "product_id" ], "title": "GetProductRelatedVideosRequest" }, "Manual1Fc51B60A782_GetShowcaseProductListRequest": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User Cookie String", "default": "Your_Cookie_String" }, "proxy": { "title": "Proxy", "description": "Optional HTTP proxy address\n - Example: `http://username:password@host:port`", "default": "", "type": [ "string", "null" ] }, "count": { "type": "integer", "title": "Count", "description": "Page Size\n\nUsage: Number of products per page (default 20)", "default": 20 }, "offset": { "type": "integer", "title": "Offset", "description": "Pagination offset (default 0)", "default": 0 } }, "type": "object", "title": "GetShowcaseProductListRequest" }, "Manual1Fc51B60A782_GetVideoOverviewRequest": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User Cookie String", "default": "Your_Cookie_String" }, "proxy": { "title": "Proxy", "description": "Optional HTTP proxy address, can be omitted if not used\n - Example format: `http://username:password@host:port`", "default": "", "type": [ "string", "null" ] } }, "type": "object", "title": "GetVideoOverviewRequest" }, "Manual1Fc51B60A782_GetVideoAssociatedProductListRequest": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User Cookie String", "default": "Your_Cookie_String" }, "proxy": { "title": "Proxy", "description": "Optional HTTP proxy address, can be omitted if not used\n - Example format: `http://username:password@host:port`", "default": "", "type": [ "string", "null" ] }, "start_date": { "type": "string", "title": "Start Date", "description": "Query Start Date, e.g. '04-01-2025'", "default": "04-01-2025" }, "item_ids": { "items": { "type": "string" }, "type": "array", "title": "Item Ids", "description": "Video ID list, for example [\"7496499484705246507\", \"7496110433699482923\"]." } }, "type": "object", "required": [ "item_ids" ], "title": "GetVideoAssociatedProductListRequest" }, "Manual1Fc51B60A782_GetVideoAudienceStatsRequest": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User Cookie String", "default": "Your_Cookie_String" }, "proxy": { "title": "Proxy", "description": "Optional HTTP proxy address, can be omitted if not used\n - Example format: `http://username:password@host:port`", "default": "", "type": [ "string", "null" ] }, "start_date": { "type": "string", "title": "Start Date", "description": "Query Start Date, e.g. '04-01-2025'", "default": "04-01-2025" }, "item_id": { "type": "string", "title": "Item Id", "description": "Video ID, for example \"7496499484705246507\"." } }, "type": "object", "required": [ "item_id" ], "title": "GetVideoAudienceStatsRequest" }, "Manual1Fc51B60A782_GetVideoDetailedStatsRequest": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User Cookie String", "default": "Your_Cookie_String" }, "proxy": { "title": "Proxy", "description": "Optional HTTP proxy address, can be omitted if not used\n - Example format: `http://username:password@host:port`", "default": "", "type": [ "string", "null" ] }, "start_date": { "type": "string", "title": "Start Date", "description": "Query Start Date, e.g. '04-01-2025'", "default": "04-01-2025" }, "item_id": { "type": "string", "title": "Item Id", "description": "Video ID, for example \"7496499484705246507\"." } }, "type": "object", "required": [ "item_id" ], "title": "GetVideoDetailedStatsRequest" }, "Manual1Fc51B60A782_GetVideoListRequest": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User Cookie String", "default": "Your_Cookie_String" }, "proxy": { "title": "Proxy", "description": "Optional HTTP proxy address, can be omitted if not used\n - Example format: `http://username:password@host:port`", "default": "", "type": [ "string", "null" ] }, "start_date": { "type": "string", "title": "Start Date", "description": "Query Start Date, e.g. '04-01-2025'", "default": "04-01-2025" }, "page": { "type": "integer", "title": "Page", "description": "Page number, default is the first page `0`", "default": 0 }, "rules": { "type": "string", "title": "Rules", "description": "List sorting rules, default is by publish time. Available options:\n - `\"VIDEO_LIST_PUBLISH_TIME\"`: Sort by video publish time\n - `\"VIDEO_LIST_GMV\"`: Sort by gross merchandise value (GMV)\n - `\"VIDEO_LIST_DIRECT_GMV\"`: Sort by direct GMV\n - `\"VIDEO_LIST_VV_CNT\"`: Sort by video view count\n - `\"VIDEO_LIST_ITEM_SOLD_CNT\"`: Sort by number of items sold\n - `\"VIDEO_LIST_CTR\"`: Sort by click-through rate\n - `\"VIDEO_LIST_COMPLETION_RATE\"`: Sort by video completion rate\n - `\"VIDEO_LIST_LIKE_CNT\"`: Sort by number of likes\n - `\"VIDEO_LIST_NEW_FOLLOWER_CNT\"`: Sort by number of new followers", "default": "VIDEO_LIST_PUBLISH_TIME" } }, "type": "object", "title": "GetVideoListRequest" }, "Manual1Fc51B60A782_GetVideoToProductStatsRequest": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User Cookie String", "default": "Your_Cookie_String" }, "proxy": { "title": "Proxy", "description": "Optional HTTP proxy address, can be omitted if not used\n - Example format: `http://username:password@host:port`", "default": "", "type": [ "string", "null" ] }, "start_date": { "type": "string", "title": "Start Date", "description": "Query Start Date, e.g. '04-01-2025'", "default": "04-01-2025" }, "item_id": { "type": "string", "title": "Item Id", "description": "Video ID, for example \"7496499484705246507\"." }, "product_id": { "type": "string", "title": "Product Id", "description": "Product ID, for example \"1731050202505515549\"." } }, "type": "object", "required": [ "item_id", "product_id" ], "title": "GetVideoToProductStatsRequest" }, "Manual1Fc51B60A782_GiftQuery": { "properties": { "gift_id": { "type": "string", "title": "Gift Id", "description": "Gift ID", "example": "10001" } }, "type": "object", "required": [ "gift_id" ], "title": "GiftQuery", "description": "Single Gift ID query model\n\nArgs:\n gift_id (str): Gift ID, e.g. \"10001\"" }, "Manual1Fc51B60A782_BatchGiftQuery": { "properties": { "gift_ids": { "items": { "type": "string" }, "type": "array", "maxItems": 1000, "minItems": 1, "title": "Gift Ids", "description": "Gift ID list, recommend 50/call for best value , auto-process first 50 if more than 50\n\nFor current API pricing, see the published x-aisa-pricing metadata. Where supported, obtain a quote for your exact request.", "example": [ "10001", "10002", "10003" ] } }, "type": "object", "required": [ "gift_ids" ], "title": "BatchGiftQuery", "description": "Batch Gift ID query model\n recommended 50 IDs per request for best value\n\nArgs:\n gift_ids (list[str]): List of gift IDs, recommended 50 per request, e.g. [\"10001\", \"10002\", \"10003\"]\n\nFor current API pricing, see the published x-aisa-pricing metadata. Where supported, obtain a quote for your exact request." }, "Manual1Fc51B60A782_Body_fetch_home_feed_api_v1_tiktok_web_fetch_home_feed_post": { "properties": { "count": { "type": "integer", "title": "Count", "description": "Number per page", "default": 15 }, "cookie": { "type": "string", "title": "Cookie", "description": "User's own cookie, optional parameter, used for personalized recommendations of interface return data." }, "region": { "type": "string", "title": "Region", "description": "Region code, optional parameter, affects the region of recommended content, e.g. US/GB/JP/KR/SG, default US.", "default": "US" } }, "type": "object", "title": "Body_fetch_home_feed_api_v1_tiktok_web_fetch_home_feed_post" }, "Manual1Fc51B60A782_XMssdkInfoModel": { "properties": { "user_agent": { "title": "User Agent", "description": "Optional User-Agent string, currently not supported for customization, defaults to a fixed value", "type": [ "string", "null" ] } }, "type": "object", "title": "XMssdkInfoModel" }, "Manual1Fc51B60A782_XBogusModel": { "properties": { "url": { "type": "string", "title": "Url", "description": "The requested API URL, no need to encode", "example": "https://www.douyin.com/aweme/v1/web/aweme/detail/?aweme_id=7148736076176215311&device_platform=webapp&aid=6383&channel=channel_pc_web&pc_client_type=1&version_code=170400&version_name=17.4.0&cookie_enabled=true&screen_width=1920&screen_height=1080&browser_language=zh-CN&browser_platform=Win32&browser_name=Edge&browser_version=117.0.2045.47&browser_online=true&engine_name=Blink&engine_version=117.0.0.0&os_name=Windows&os_version=10&cpu_core_num=128&device_memory=10240&platform=PC&downlink=10&effective_type=4g&round_trip_time=100" }, "user_agent": { "type": "string", "title": "User Agent", "description": "User-Agent when requesting the API", "example": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/90.0.4430.212 Safari/537.36" } }, "type": "object", "required": [ "url", "user_agent" ], "title": "XBogusModel" }, "Manual1Fc51B60A782_XGnarlyAndXBogusModel": { "properties": { "url": { "type": "string", "title": "Url", "description": "The requested API URL including domain and parameters, no need to URL encode", "example": "https://www.tiktok.com/api/search/user/full/?WebIdLastTime=1756087650&aid=1988&app_language=zh-Hans&app_name=tiktok_web&browser_language=zh-CN&browser_name=Mozilla&browser_online=true&browser_platform=MacIntel&browser_version=5.0%20%28Macintosh%3B%20Intel%20Mac%20OS%20X%2010_15_7%29%20AppleWebKit%2F537.36%20%28KHTML%2C%20like%20Gecko%29%20Chrome%2F139.0.0.0%20Safari%2F537.36&channel=tiktok_web&cookie_enabled=true&cursor=10&data_collection_enabled=false&device_id=7542339104672111234&device_platform=web_pc&focus_state=true&from_page=search&history_len=3&is_fullscreen=true&is_page_visible=true&keyword=musk&odinId=7542338997269211234&os=mac&priority_region&referer®ion=US&screen_height=967&screen_width=1496&search_id&tz_name=America%2FLos_Angeles&user_is_login=false&web_search_code=%7B%22tiktok%22%3A%7B%22client_params_x%22%3A%7B%22search_engine%22%3A%7B%22ies_mt_user_live_video_card_use_libra%22%3A1%2C%22mt_search_general_user_live_card%22%3A1%7D%7D%2C%22search_server%22%3A%7B%7D%7D%7D&webcast_language=zh-Hans" }, "body": { "title": "Body", "description": "The API parameters of the request, applicable for POST requests", "default": "", "type": [ "string", "null" ] } }, "type": "object", "required": [ "url" ], "title": "XGnarlyAndXBogusModel" }, "Manual1Fc51B60A782_FetchChannelIdToUsernameRequest": { "properties": { "channel_id": { "type": "string", "maxLength": 64, "pattern": "^sph[A-Za-z0-9_-]+$", "title": "Channel Id", "description": "WeChat Channels ID (short ID starting with sph\n\nUsage: Channel ID (`sph…` short ID), e.g. `sphi9BjV8GK0Zsl` (People's Daily). Must start with `sph`.", "example": "sphi9BjV8GK0Zsl" }, "raw": { "type": "boolean", "title": "Raw", "description": "True=raw response; False=simplified parsed structure", "default": false } }, "type": "object", "required": [ "channel_id" ], "title": "FetchChannelIdToUsernameRequest" }, "Manual1Fc51B60A782_FetchChannelInfoRequest": { "properties": { "username": { "type": "string", "maxLength": 256, "minLength": 10, "pattern": "^v2_[0-9a-fA-F]+@finder$", "title": "Username", "description": "WeChat Channels finder username (`v2_…@finder` format), e.g. `v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder` (People's Daily).\n - How to get it:\n - The `username` field of each video object in `fetch_video_detail` / `fetch_user_videos` responses (most common)\n - `fetch_channel_id_to_username`: convert a Channel ID (`sph…` short ID, e.g. `sphi9BjV8GK0Zsl`) into a finder username\n\nAPI references: `fetch_channel_id_to_username` = `POST /tikhub/wechat_channels/v2/fetch_channel_id_to_username` (operationId: `post_tikhub_wechat_channels_v2_fetch_channel_id_to_username`); `fetch_user_videos` = `POST /tikhub/wechat_channels/v2/fetch_user_videos` (operationId: `post_tikhub_wechat_channels_v2_fetch_user_videos`); `fetch_video_detail` = `POST /tikhub/wechat_channels/v2/fetch_video_detail` (operationId: `post_tikhub_wechat_channels_v2_fetch_video_detail`).", "example": "v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder" }, "raw": { "type": "boolean", "title": "Raw", "description": "True=raw response; False=simplified parsed structure", "default": true } }, "type": "object", "required": [ "username" ], "title": "FetchChannelInfoRequest" }, "Manual1Fc51B60A782_FetchCollectionVideosRequest": { "properties": { "topic_id": { "type": "string", "maxLength": 32, "pattern": "^[0-9]+$", "title": "Topic Id", "description": "Numeric collection ID from topic_id of fetch_user_collections, for example \"14616794565351966924\".\n\nAPI references: `fetch_user_collections` = `POST /tikhub/wechat_channels/v2/fetch_user_collections` (operationId: `post_tikhub_wechat_channels_v2_fetch_user_collections`).", "example": "14616794565351966924" }, "topic": { "title": "Topic", "description": "Optional collection name; use the name returned by fetch_user_collections to improve the match.\n\nAPI references: `fetch_user_collections` = `POST /tikhub/wechat_channels/v2/fetch_user_collections` (operationId: `post_tikhub_wechat_channels_v2_fetch_user_collections`).", "default": "", "example": "早安中国", "type": [ "string", "null" ], "maxLength": 100 }, "username": { "title": "Username", "description": "Optional, creator finder username (`v2_…@finder` format), improves hit rate.", "default": "", "example": "v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder", "type": [ "string", "null" ], "maxLength": 256, "pattern": "^(v2_[0-9a-fA-F]+@finder)?$" }, "last_buffer": { "title": "Last Buffer", "description": "Optional pagination cursor (base64), **leave empty for the first page**; when `down_continue` is truthy, pass the previous page's `last_buffer`.", "default": "", "type": [ "string", "null" ], "pattern": "^[A-Za-z0-9+/=_-]*$" }, "topic_type": { "type": "integer", "maximum": 1000.0, "minimum": 0.0, "title": "Topic Type", "description": "Optional, collection type, default 16 (align with the collection's `topic_type` from `fetch_user_collections`).\n\nAPI references: `fetch_user_collections` = `POST /tikhub/wechat_channels/v2/fetch_user_collections` (operationId: `post_tikhub_wechat_channels_v2_fetch_user_collections`).", "default": 16 }, "raw": { "type": "boolean", "title": "Raw", "description": "True=raw response; False=simplified parsed structure (recommended for media download", "default": true } }, "type": "object", "required": [ "topic_id" ], "title": "FetchCollectionVideosRequest" }, "Manual1Fc51B60A782_FetchLiveDetailRequest": { "properties": { "live_id": { "type": "string", "maxLength": 32, "pattern": "^[0-9]+$", "title": "Live Id", "description": "Live ID (numeric). Source: replay items of `fetch_live_history`, live entry, or live share. E.g. `2078950291205875194`.\n\nAPI references: `fetch_live_history` = `POST /tikhub/wechat_channels/v2/fetch_live_history` (operationId: `post_tikhub_wechat_channels_v2_fetch_live_history`).", "example": "2078950291205875194" }, "scene": { "type": "integer", "maximum": 1000.0, "minimum": 0.0, "title": "Scene", "description": "Entry scene, default 5", "default": 5 }, "finder_username": { "title": "Finder Username", "description": "Optional, anchor finder username (`v2_…@finder` format), improves hit rate. E.g. `v2_060000231003b20faec8cae1811ac4d5c702ea32b0771737aa785454f7f8177114cc4d248d66@finder` (Huxiu).", "default": "", "example": "v2_060000231003b20faec8cae1811ac4d5c702ea32b0771737aa785454f7f8177114cc4d248d66@finder", "type": [ "string", "null" ], "maxLength": 256, "pattern": "^(v2_[0-9a-fA-F]+@finder)?$" }, "raw": { "type": "boolean", "title": "Raw", "description": "True=raw response; False=simplified parsed structure", "default": true } }, "type": "object", "required": [ "live_id" ], "title": "FetchLiveDetailRequest" }, "Manual1Fc51B60A782_FetchLiveHistoryRequest": { "properties": { "username": { "type": "string", "maxLength": 256, "minLength": 10, "pattern": "^v2_[0-9a-fA-F]+@finder$", "title": "Username", "description": "WeChat Channels finder username (`v2_…@finder` format). Example (an account with live replays): `v2_060000231003b20faec8cae1811ac4d5c702ea32b0771737aa785454f7f8177114cc4d248d66@finder` (Huxiu).", "example": "v2_060000231003b20faec8cae1811ac4d5c702ea32b0771737aa785454f7f8177114cc4d248d66@finder" }, "last_buffer": { "title": "Last Buffer", "description": "Optional pagination cursor (base64), **leave empty for the first page**; when `continue_flag` is truthy, pass the previous page's `last_buffer`.", "default": "", "type": [ "string", "null" ], "pattern": "^[A-Za-z0-9+/=_-]*$" }, "flag": { "type": "integer", "maximum": 1000.0, "minimum": 0.0, "title": "Flag", "description": "Fetch flag, default 12", "default": 12 }, "raw": { "type": "boolean", "title": "Raw", "description": "True=raw response; False=simplified parsed structure (recommended for media download", "default": true } }, "type": "object", "required": [ "username" ], "title": "FetchLiveHistoryRequest" }, "Manual1Fc51B60A782_FetchSearchChannelVideosRequest": { "properties": { "username": { "type": "string", "maxLength": 256, "minLength": 10, "pattern": "^v2_[0-9a-fA-F]+@finder$", "title": "Username", "description": "Creator finder username (v2_…@finder format", "example": "v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder" }, "keyword": { "type": "string", "maxLength": 100, "minLength": 1, "title": "Keyword", "description": "Keyword to search within this channel (1-100 chars", "example": "news" }, "cursor": { "title": "Cursor", "description": "Pagination cursor. Leave empty for the first page, then pass the previous response next_cursor verbatim. The cursor is opaque; do not parse or concatenate it.", "type": [ "string", "null" ], "maxLength": 4096 }, "raw": { "type": "boolean", "title": "Raw", "description": "True=raw response; False=simplified parsed structure", "default": true } }, "type": "object", "required": [ "username", "keyword" ], "title": "FetchSearchChannelVideosRequest" }, "Manual1Fc51B60A782_FetchUserCollectionsRequest": { "properties": { "username": { "type": "string", "maxLength": 256, "minLength": 10, "pattern": "^v2_[0-9a-fA-F]+@finder$", "title": "Username", "description": "WeChat Channels finder username (`v2_…@finder` format). E.g. `v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder` (People's Daily).", "example": "v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder" }, "raw": { "type": "boolean", "title": "Raw", "description": "True=raw response; False=simplified parsed structure", "default": true } }, "type": "object", "required": [ "username" ], "title": "FetchUserCollectionsRequest" }, "Manual1Fc51B60A782_FetchUserProfileRequest": { "properties": { "username": { "type": "string", "maxLength": 256, "minLength": 10, "pattern": "^v2_[0-9a-fA-F]+@finder$", "title": "Username", "description": "WeChat Channels finder username (`v2_…@finder` format). Source: the `username` field of video objects in `fetch_video_detail` / `fetch_user_videos` responses; or convert a `sph…` short ID via `fetch_channel_id_to_username`. E.g. `v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder` (People's Daily).\n\nAPI references: `fetch_channel_id_to_username` = `POST /tikhub/wechat_channels/v2/fetch_channel_id_to_username` (operationId: `post_tikhub_wechat_channels_v2_fetch_channel_id_to_username`); `fetch_user_videos` = `POST /tikhub/wechat_channels/v2/fetch_user_videos` (operationId: `post_tikhub_wechat_channels_v2_fetch_user_videos`); `fetch_video_detail` = `POST /tikhub/wechat_channels/v2/fetch_video_detail` (operationId: `post_tikhub_wechat_channels_v2_fetch_video_detail`).", "example": "v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder" }, "raw": { "type": "boolean", "title": "Raw", "description": "True=raw response; False=simplified parsed structure", "default": true } }, "type": "object", "required": [ "username" ], "title": "FetchUserProfileRequest" }, "Manual1Fc51B60A782_FetchUserVideosRequest": { "properties": { "username": { "type": "string", "maxLength": 256, "minLength": 10, "pattern": "^v2_[0-9a-fA-F]+@finder$", "title": "Username", "description": "WeChat Channels finder username (`v2_…@finder` format), e.g. `v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder` (People's Daily). See `fetch_channel_info` / `fetch_video_detail` / `fetch_channel_id_to_username` docs for how to obtain it.\n\nAPI references: `fetch_channel_id_to_username` = `POST /tikhub/wechat_channels/v2/fetch_channel_id_to_username` (operationId: `post_tikhub_wechat_channels_v2_fetch_channel_id_to_username`); `fetch_channel_info` = `POST /tikhub/wechat_channels/v2/fetch_channel_info` (operationId: `post_tikhub_wechat_channels_v2_fetch_channel_info`); `fetch_video_detail` = `POST /tikhub/wechat_channels/v2/fetch_video_detail` (operationId: `post_tikhub_wechat_channels_v2_fetch_video_detail`).", "example": "v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder" }, "last_buffer": { "title": "Last Buffer", "description": "Optional pagination cursor (base64). **Leave empty for the first page**; when `up_continue` in the response is truthy, pass the previous page's `last_buffer` to get the next page. (base64 contains `+//=` characters, hence body instead of query.)", "default": "", "type": [ "string", "null" ], "pattern": "^[A-Za-z0-9+/=_-]*$" }, "raw": { "type": "boolean", "title": "Raw", "description": "True=raw response; False=simplified parsed structure (recommended for media download", "default": true } }, "type": "object", "required": [ "username" ], "title": "FetchUserVideosRequest" }, "Manual1Fc51B60A782_FetchVideoCommentsRequest": { "properties": { "object_id": { "type": "string", "maxLength": 32, "pattern": "^[0-9]+$", "title": "Object Id", "description": "Video objectId (numeric), e.g. `14941130915890399732`. From the video `id` of `fetch_user_videos` / `fetch_video_detail`.\n\nAPI references: `fetch_user_videos` = `POST /tikhub/wechat_channels/v2/fetch_user_videos` (operationId: `post_tikhub_wechat_channels_v2_fetch_user_videos`); `fetch_video_detail` = `POST /tikhub/wechat_channels/v2/fetch_video_detail` (operationId: `post_tikhub_wechat_channels_v2_fetch_video_detail`).", "example": "14941130915890399732" }, "last_buffer": { "title": "Last Buffer", "description": "Optional pagination cursor (base64). **Leave empty for the first page**; when `down_continue` is truthy, pass the previous page's `last_buffer`.", "default": "", "type": [ "string", "null" ], "pattern": "^[A-Za-z0-9+/=_-]*$" }, "comment_id": { "title": "Comment Id", "description": "Pass a commentId (numeric) to expand its replies, leave empty for first-level comments\n\nUsage: Optional. To expand the replies of a comment, pass its `comment_id` (numeric); leave empty for the first-level page.", "default": "", "type": [ "string", "null" ], "maxLength": 32, "pattern": "^[0-9]*$" }, "raw": { "type": "boolean", "title": "Raw", "description": "True=raw response; False=simplified parsed structure", "default": true } }, "type": "object", "required": [ "object_id" ], "title": "FetchVideoCommentsRequest" }, "Manual1Fc51B60A782_FetchVideoDetailRequest": { "properties": { "object_id": { "title": "Object Id", "description": "Highest priority, optional. Video objectId (numeric), e.g. `14941130915890399732`. Obtainable from the video `id` of `fetch_user_videos` / `fetch_collection_videos`.\n\nAPI references: `fetch_collection_videos` = `POST /tikhub/wechat_channels/v2/fetch_collection_videos` (operationId: `post_tikhub_wechat_channels_v2_fetch_collection_videos`); `fetch_user_videos` = `POST /tikhub/wechat_channels/v2/fetch_user_videos` (operationId: `post_tikhub_wechat_channels_v2_fetch_user_videos`).", "default": "", "example": "14941130915890399732", "type": [ "string", "null" ], "maxLength": 32, "pattern": "^[0-9]*$" }, "export_id": { "title": "Export Id", "description": "Second priority, optional. `exportId` from search results (must start with `export/`). Search results often only carry `exportId` without a plain object_id — pass export_id directly in that case (it expires, use it soon).", "default": "", "type": [ "string", "null" ], "maxLength": 2048, "pattern": "^(export/.+)?$" }, "object_nonce_id": { "title": "Object Nonce Id", "description": "Optional objectNonceId (numeric, improves hit rate\n\nUsage: Optional. `feedNonceId` (numeric) from search results, pairs with the above to improve hit rate.", "default": "", "type": [ "string", "null" ], "maxLength": 32, "pattern": "^[0-9]*$" }, "share_url": { "title": "Share Url", "description": "Last, optional. Channels share URL (`https://weixin.qq.com/sph/…`), e.g. `https://weixin.qq.com/sph/AH3sCoIPhH`. Used only when both object_id and export_id are empty.", "default": "", "type": [ "string", "null" ], "maxLength": 256, "pattern": "^(https?://weixin\\.qq\\.com/sph/[A-Za-z0-9]+/?)?$" }, "raw": { "type": "boolean", "title": "Raw", "description": "True=raw response; False=simplified parsed structure (recommended for media download", "default": true } }, "type": "object", "title": "FetchVideoDetailRequest" }, "Manual1Fc51B60A782_FetchVideoShareUrlRequest": { "properties": { "object_id": { "type": "string", "maxLength": 32, "pattern": "^[0-9]+$", "title": "Object Id", "description": "Video objectId (numeric), e.g. `14941130915890399732`. From the video `id` of `fetch_user_videos` / `fetch_video_detail`.\n\nAPI references: `fetch_user_videos` = `POST /tikhub/wechat_channels/v2/fetch_user_videos` (operationId: `post_tikhub_wechat_channels_v2_fetch_user_videos`); `fetch_video_detail` = `POST /tikhub/wechat_channels/v2/fetch_video_detail` (operationId: `post_tikhub_wechat_channels_v2_fetch_video_detail`).", "example": "14941130915890399732" }, "raw": { "type": "boolean", "title": "Raw", "description": "True=raw response; False=simplified parsed structure", "default": true } }, "type": "object", "required": [ "object_id" ], "title": "FetchVideoShareUrlRequest" }, "Manual1Fc51B60A782_FetchAccountArticlesRequest": { "properties": { "username": { "type": "string", "maxLength": 80, "pattern": "^[0-9A-Za-z][-_0-9A-Za-z]{1,63}(@[0-9A-Za-z]{1,16})?$", "title": "Username", "description": "Official account username. Three forms are supported: `gh_…`, `gh_…@app` (mini-program-linked accounts) and custom WeChat IDs (e.g. `nikejdi`). Taken from `$.data.content.user_name` of the article detail endpoints\n\nUsage: Official account `gh_username` (`gh_…`). E.g. `gh_363b924965e9`", "example": "gh_363b924965e9" }, "page_size": { "type": "integer", "maximum": 100.0, "minimum": 1.0, "title": "Page Size", "description": "Articles per page (default 20). WeChat currently ignores this parameter; the account determines the returned count. Paginate using offset and next_offset.", "default": 20 }, "offset": { "title": "Offset", "description": "Optional pagination cursor (base64), **leave empty for the first page**; for the next page pass `next_offset` from the previous response. E.g. `CAMQChiS5KfRBiAKOJLkp9EGQABIAVgAYABwAQ==`", "default": "", "type": [ "string", "null" ], "maxLength": 8192, "pattern": "^[A-Za-z0-9+/=_-]*$" }, "item_show_type": { "title": "Item Show Type", "description": "Optional content tab (matches the \"Articles / Videos / Audios\" tabs on the account homepage). Empty / `0`=articles (default), `5`=videos, `7`=audios, `8`=image-text posts. Omitting it = articles, behavior unchanged.", "type": [ "integer", "null" ] }, "raw": { "type": "boolean", "title": "Raw", "description": "True=raw response; False=simplified parsed structure", "default": true } }, "type": "object", "required": [ "username" ], "title": "FetchAccountArticlesRequest" }, "Manual1Fc51B60A782_FetchAccountRequest": { "properties": { "username": { "type": "string", "maxLength": 80, "pattern": "^[0-9A-Za-z][-_0-9A-Za-z]{1,63}(@[0-9A-Za-z]{1,16})?$", "title": "Username", "description": "Official account username. Three forms are supported: `gh_…`, `gh_…@app` (mini-program-linked accounts) and custom WeChat IDs (e.g. `nikejdi`). Taken from `$.data.content.user_name` of the article detail endpoints", "example": "gh_363b924965e9" }, "raw": { "type": "boolean", "title": "Raw", "description": "True=raw response; False=simplified parsed structure", "default": true } }, "type": "object", "required": [ "username" ], "title": "FetchAccountRequest" }, "Manual1Fc51B60A782_FetchArticleDetailRequest": { "properties": { "url": { "type": "string", "maxLength": 2048, "pattern": "^https?://mp\\.weixin\\.qq\\.com/s([/?].+)?$", "title": "Url", "description": "… or long URL with __biz", "example": "https://mp.weixin.qq.com/s/TSNQKkRpN1qbKsT7BvzqIw" }, "raw": { "type": "boolean", "title": "Raw", "description": "True=raw response; False=simplified parsed structure", "default": true } }, "type": "object", "required": [ "url" ], "title": "FetchArticleDetailRequest" }, "Manual1Fc51B60A782_FetchArticleCommentsRequest": { "properties": { "url": { "type": "string", "maxLength": 2048, "pattern": "^https?://mp\\.weixin\\.qq\\.com/s([/?].+)?$", "title": "Url", "description": "WeChat MP article URL (`https://mp.weixin.qq.com/s/…`). E.g. `https://mp.weixin.qq.com/s/TSNQKkRpN1qbKsT7BvzqIw`", "example": "https://mp.weixin.qq.com/s/TSNQKkRpN1qbKsT7BvzqIw" }, "buffer": { "title": "Buffer", "description": "Optional, default empty. Pagination cursor; leave empty for the first page, pass `buffer` from the previous response for the next page.", "default": "", "type": [ "string", "null" ], "maxLength": 8192 }, "comment_id": { "title": "Comment Id", "description": "Article comment id (optional, performance shortcut): when omitted, upstream must fetch and parse the whole article HTML to obtain it, which accounts for about half of this endpoint's latency", "type": [ "string", "null" ], "maxLength": 32, "pattern": "^[0-9]*$" }, "raw": { "type": "boolean", "title": "Raw", "description": "True=raw response; False=simplified parsed structure", "default": true } }, "type": "object", "required": [ "url" ], "title": "FetchArticleCommentsRequest" }, "Manual1Fc51B60A782_FetchArticleStatsH5Request": { "properties": { "url": { "type": "string", "maxLength": 2048, "pattern": "^https?://mp\\.weixin\\.qq\\.com/s([/?].+)?$", "title": "Url", "description": "… or long URL with __biz", "example": "https://mp.weixin.qq.com/s/TSNQKkRpN1qbKsT7BvzqIw" }, "raw": { "type": "boolean", "title": "Raw", "description": "True=raw response; False=simplified parsed structure", "default": true }, "comment_id": { "title": "Comment Id", "description": "Article comment id (optional, performance shortcut): when omitted, upstream must fetch and parse the whole article HTML to obtain it, which accounts for about half of this endpoint's latency", "type": [ "string", "null" ], "maxLength": 32, "pattern": "^[0-9]*$" } }, "type": "object", "required": [ "url" ], "title": "FetchArticleStatsH5Request", "description": "`/tikhub/wechat_mp/v2/fetch_article_stats_h5` FetchArticleDetailRequest comment_id\n\nAPI references: `fetch_article_stats_h5` = `POST /tikhub/wechat_mp/v2/fetch_article_stats_h5` (operationId: `post_tikhub_wechat_mp_v2_fetch_article_stats_h5`)." }, "Manual1Fc51B60A782_FetchCommentRepliesRequest": { "properties": { "url": { "type": "string", "maxLength": 2048, "pattern": "^https?://mp\\.weixin\\.qq\\.com/s([/?].+)?$", "title": "Url", "description": "WeChat MP article URL (`https://mp.weixin.qq.com/s/…`). E.g. `http://mp.weixin.qq.com/s?__biz=Mzk3NTA0MzM5NA==&mid=2247483745&idx=1&sn=3f34e768cf457a501038991ed30be1f4#rd`", "example": "http://mp.weixin.qq.com/s?__biz=Mzk3NTA0MzM5NA==&mid=2247483745&idx=1&sn=3f34e768cf457a501038991ed30be1f4#rd" }, "content_id": { "title": "Content Id", "description": "Optional (numeric). `content_id` of the target first-level comment, from `$.data.comments[N].content_id` of the `fetch_article_comments` response; **defaults to the first comment that has replies when omitted**. E.g. `12109128638545265979`\n\nAPI references: `fetch_article_comments` = `POST /tikhub/wechat_mp/v2/fetch_article_comments` (operationId: `post_tikhub_wechat_mp_v2_fetch_article_comments`).", "default": "", "example": "12109128638545265979", "type": [ "string", "null" ], "maxLength": 32, "pattern": "^[0-9]*$" }, "offset": { "type": "integer", "minimum": 0.0, "title": "Offset", "description": "Optional, default 0 (>=0). Reply pagination offset; 0 for the first page, pass `next_offset` from the previous response when `has_more=true`.", "default": 0 }, "comment_id": { "title": "Comment Id", "description": "Article comment id (optional, performance shortcut): when omitted, upstream must fetch and parse the whole article HTML to obtain it, which accounts for about half of this endpoint's latency", "type": [ "string", "null" ], "maxLength": 32, "pattern": "^[0-9]*$" }, "raw": { "type": "boolean", "title": "Raw", "description": "True=raw response; False=simplified parsed structure", "default": true } }, "type": "object", "required": [ "url" ], "title": "FetchCommentRepliesRequest" }, "Manual1Fc51B60A782_FetchSearchRequest": { "properties": { "keyword": { "type": "string", "maxLength": 100, "minLength": 1, "title": "Keyword", "description": "Search keyword, 1-100 characters after trimming. For account searches, use the account display name.", "example": "People's Daily" }, "business_type": { "type": "string", "enum": [ "all", "account", "article", "video", "sticker", "underline", "encyclopedia", "live_stream", "comment", "listen", "news", "photos", "book", "moments", "image", "mini_game", "weixin_index", "ai_search" ], "title": "Business Type", "description": "ai_search) are gated server-side per account & region and currently always come back empty (count=0 plus a no_more message — still billed as a normal call). Use the `categories` field of an `all` search for the authoritative per-account tab list. Values outside this list are rejected (422\n\nUsage: Optional, default `all`. Vertical string key (18 total). **Verified to return data**: `all` / `account` / `article` / `video` / `sticker`. The rest (`underline` / `encyclopedia` / `live_stream` / `comment` / `listen` / `news` / `photos` / `book` / `moments` / `image` / `mini_game` / `weixin_index` / `ai_search`) are gated server-side per account & region and currently always come back empty. Any value outside this list is rejected (422).", "default": "all", "example": "account" }, "sort": { "anyOf": [ { "type": "integer" }, { "type": "string" } ], "title": "Sort", "description": "Optional, default `default`. Sort (result page \"sort\" dropdown, common to all verticals) — `default`/0 (relevance) / `latest`/1 (newest) / `hot`/2 (most liked); string key or integer, invalid values rejected (400).", "default": "default", "example": "hot" }, "publish_time": { "anyOf": [ { "type": "integer" }, { "type": "string" } ], "title": "Publish Time", "description": "Optional, default `all`. Publish time (result page \"time\" dropdown, common) — `all`/0 / `day`/1 / `week`/2 / `half_year`/3; string key or integer, invalid values rejected (400).", "default": "all", "example": "week" }, "offset": { "type": "integer", "minimum": 0.0, "title": "Offset", "description": "Optional, default 0 (>=0). Pass `0` for the first page; **use `cursor` to paginate — offset alone does not work** (it returns the first page every time).", "default": 0 }, "cursor": { "title": "Cursor", "description": "Optional. Pagination cursor. Leave empty for the first page; for the next page pass back the `cursor` returned in the previous response (repeat the same `sort` / `publish_time`), and use `continue_flag` to check whether there are more pages.", "type": [ "string", "null" ] }, "raw": { "type": "boolean", "title": "Raw", "description": "True=raw search response; False=simplified parsed structure", "default": true } }, "type": "object", "required": [ "keyword" ], "title": "FetchSearchRequest" }, "Manual1Fc51B60A782_FetchSearchVideosRequest": { "properties": { "keyword": { "type": "string", "maxLength": 100, "minLength": 1, "title": "Keyword", "description": "Search keyword, 1-100 characters after trimming.", "example": "food" }, "duration": { "anyOf": [ { "type": "integer" }, { "type": "string" } ], "title": "Duration", "description": "Duration filter for Channels videos: all/0 (default), short/1 (under 5 minutes), medium/2 (5-10 minutes), long/3 (20 minutes or more). Accepts either a string key or integer; invalid values return HTTP 400.", "default": "all", "example": "short" }, "sort": { "anyOf": [ { "type": "integer" }, { "type": "string" } ], "title": "Sort", "description": "Sort order: default/0=relevance (default), latest/1=newest, hot/2=most liked. Accepts either a string key or integer; invalid values return HTTP 400.", "default": "default", "example": "hot" }, "publish_time": { "anyOf": [ { "type": "integer" }, { "type": "string" } ], "title": "Publish Time", "description": "Publication-time filter: all/0 (default), day/1, week/2, half_year/3. Accepts either a string key or integer; invalid values return HTTP 400.", "default": "all", "example": "week" }, "offset": { "type": "integer", "minimum": 0.0, "title": "Offset", "description": "Offset, default 0 and minimum 0. Use cursor for pagination; offset alone does not advance the result page.", "default": 0 }, "cursor": { "title": "Cursor", "description": "Pagination cursor, as in /tikhub/wechat_search/v2/fetch_search. Leave empty for the first page, then pass the previous response cursor verbatim while keeping duration, sort, and publish_time unchanged.\n\nAPI references: `fetch_search` = `POST /tikhub/wechat_search/v2/fetch_search` (operationId: `post_tikhub_wechat_search_v2_fetch_search`).", "type": [ "string", "null" ] }, "raw": { "type": "boolean", "title": "Raw", "description": "True=raw search response; False=simplified parsed structure", "default": true } }, "type": "object", "required": [ "keyword" ], "title": "FetchSearchVideosRequest" }, "Manual1Fc51B60A782_CoreDataReq": { "properties": { "user_id": { "type": "string", "title": "User Id", "description": "Blogger user ID", "example": "5c668b3e0000000012021605" }, "business": { "type": "integer", "enum": [ 0, 1 ], "title": "Business", "description": "Note scope: 0=Organic notes (default), 1=Sponsored notes", "default": 0, "example": 0 }, "note_type": { "type": "integer", "enum": [ 1, 2, 3 ], "title": "Note Type", "description": "Note type: 3=Image & text + Video (default), 1=Image & text, 2=Video\n\nUsage: 3=image-text+video (default), 1=image-text, 2=video\n **Warning**: differs from the upstream V1 note-list endpoint (not exposed in this specification), where 4=all and 3=sponsored", "default": 3, "example": 3 }, "date_type": { "type": "integer", "enum": [ 1, 2 ], "title": "Date Type", "description": "Date range: 1=last 30 days (default), 2=last 90 days", "default": 1, "example": 1 }, "advertise_switch": { "type": "integer", "enum": [ 0, 1 ], "title": "Advertise Switch", "description": "Traffic type: 1=All (including sponsored), 0=Organic only\n\nUsage: 1=all traffic (default), 0=organic only", "default": 1, "example": 1 } }, "additionalProperties": false, "type": "object", "required": [ "user_id" ], "title": "CoreDataReq" }, "Manual1Fc51B60A782_DataSummaryReq": { "properties": { "user_id": { "type": "string", "title": "User Id", "description": "Blogger user ID", "example": "5c668b3e0000000012021605" }, "business": { "type": "integer", "enum": [ 0, 1 ], "title": "Business", "description": "Note scope: 0=Organic notes (default), 1=Sponsored notes", "default": 0, "example": 0 } }, "additionalProperties": false, "type": "object", "required": [ "user_id" ], "title": "DataSummaryReq" }, "Manual1Fc51B60A782_UserIdReq": { "properties": { "user_id": { "type": "string", "title": "User Id", "description": "Blogger user ID", "example": "5c668b3e0000000012021605" } }, "additionalProperties": false, "type": "object", "required": [ "user_id" ], "title": "UserIdReq" }, "Manual1Fc51B60A782_FansHistoryReq": { "properties": { "user_id": { "type": "string", "title": "User Id", "description": "Blogger user ID", "example": "5c668b3e0000000012021605" }, "increase_type": { "type": "integer", "enum": [ 1, 2 ], "title": "Increase Type", "description": "Curve: 1=total followers (default, cumulative), 2=daily follower increment", "default": 1, "example": 1 }, "date_type": { "type": "integer", "enum": [ 1, 2 ], "title": "Date Type", "description": "Date range: 1=last 30 days (default), 2=last 60 days", "default": 1, "example": 1 } }, "additionalProperties": false, "type": "object", "required": [ "user_id" ], "title": "FansHistoryReq" }, "Manual1Fc51B60A782_NotesRateReq": { "properties": { "user_id": { "type": "string", "title": "User Id", "description": "Blogger user ID", "example": "5c668b3e0000000012021605" }, "business": { "type": "integer", "enum": [ 0, 1 ], "title": "Business", "description": "Note scope: 0=organic (default), 1=sponsored", "default": 0, "example": 0 }, "note_type": { "type": "integer", "enum": [ 1, 2, 3 ], "title": "Note Type", "description": "Note type: 3=image and video notes (default), 1=image notes, 2=video notes. The upstream V1 get_blogger_notes endpoint uses different values: 4=all, 3=sponsored. That endpoint is not exposed in this specification.", "default": 3, "example": 3 }, "date_type": { "type": "integer", "enum": [ 1, 2 ], "title": "Date Type", "description": "Date range: 1=last 30 days (default), 2=last 90 days", "default": 1, "example": 1 }, "advertise_switch": { "type": "integer", "enum": [ 0, 1 ], "title": "Advertise Switch", "description": "Traffic type: 1=All (including sponsored), 0=Organic only\n\nUsage: 1=all traffic (default), 0=organic only", "default": 1, "example": 1 } }, "additionalProperties": false, "type": "object", "required": [ "user_id" ], "title": "NotesRateReq" }, "Manual1Fc51B60A782_NotesV2Req": { "properties": { "user_id": { "type": "string", "title": "User Id", "description": "Blogger user ID", "example": "5c668b3e0000000012021605" }, "page_number": { "type": "integer", "maximum": 1000.0, "minimum": 1.0, "title": "Page Number", "description": "Page number, from 1", "default": 1, "example": 1 }, "page_size": { "type": "integer", "maximum": 8.0, "minimum": 1.0, "title": "Page Size", "description": "Page size, 1-8 (fixed at 8 on PGY web)", "default": 8, "example": 8 }, "note_type": { "type": "integer", "enum": [ 0, 1, 2 ], "title": "Note Type", "description": "Note type: 0=All types (default), 1=Image & text, 2=Video\n\nUsage: 0=all (default), 1=image-text, 2=video", "default": 0, "example": 0 }, "order_type": { "type": "integer", "enum": [ 1, 2, 3 ], "title": "Order Type", "description": "Sort: 1=Latest (default), 2=Most read, 3=Most engaged\n\nUsage: 1=newest (default), 2=most read, 3=most engaged", "default": 1, "example": 1 } }, "additionalProperties": false, "type": "object", "required": [ "user_id" ], "title": "NotesV2Req" }, "Manual1Fc51B60A782_SimilarReq": { "properties": { "user_id": { "type": "string", "title": "User Id", "description": "Target blogger user ID", "example": "5c668b3e0000000012021605" }, "page_num": { "type": "integer", "maximum": 100.0, "minimum": 1.0, "title": "Page Num", "description": "Page", "default": 1, "example": 1 }, "page_size": { "type": "integer", "maximum": 4.0, "minimum": 1.0, "title": "Page Size", "description": "Page size, 1-4 (web fixed at 4)\n\nUsage: **1-4** (fixed at 4 on the PGY web page)", "default": 4, "example": 4 } }, "additionalProperties": false, "type": "object", "required": [ "user_id" ], "title": "SimilarReq" }, "Manual1Fc51B60A782_KeywordReq": { "properties": { "search_word": { "type": "string", "maxLength": 100, "minLength": 1, "title": "Search Word", "description": "Keyword, e.g., face mask", "example": "Face Mask" } }, "additionalProperties": false, "type": "object", "required": [ "search_word" ], "title": "KeywordReq" }, "Manual1Fc51B60A782_NoteDetailReq": { "properties": { "note_id": { "type": "string", "title": "Note Id", "description": "Note ID", "example": "6a20edfa0000000021020951" } }, "additionalProperties": false, "type": "object", "required": [ "note_id" ], "title": "NoteDetailReq" }, "Manual1Fc51B60A782_CommentSortByAPI": { "type": "string", "enum": [ "top", "newest" ], "title": "CommentSortByAPI", "description": "See API documentation" } }, "responses": {}, "parameters": {}, "examples": {}, "requestBodies": {}, "headers": {}, "links": {}, "callbacks": {}, "pathItems": {} }, "info": { "description": "", "title": "TikHub (multi-platform social media data API)", "version": "1", "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" } }, "x-aisa-configured-paths": [ "/apis/v1/tikhub/bilibili/app/fetch_bangumi_tab", "/apis/v1/tikhub/bilibili/app/fetch_cinema_tab", "/apis/v1/tikhub/bilibili/app/fetch_home_feed", "/apis/v1/tikhub/bilibili/app/fetch_one_video", "/apis/v1/tikhub/bilibili/app/fetch_popular_feed", "/apis/v1/tikhub/bilibili/app/fetch_reply_detail", "/apis/v1/tikhub/bilibili/app/fetch_search_all", "/apis/v1/tikhub/bilibili/app/fetch_search_by_type", "/apis/v1/tikhub/bilibili/app/fetch_user_info", "/apis/v1/tikhub/bilibili/app/fetch_user_videos", "/apis/v1/tikhub/bilibili/app/fetch_video_comments", "/apis/v1/tikhub/bilibili/huahuo/account_session_info", "/apis/v1/tikhub/bilibili/huahuo/cooperate_experience_industry", "/apis/v1/tikhub/bilibili/huahuo/dmp_pkg_list", "/apis/v1/tikhub/bilibili/huahuo/effect_goods_drop", "/apis/v1/tikhub/bilibili/huahuo/industry_tags", "/apis/v1/tikhub/bilibili/huahuo/label_char_style", "/apis/v1/tikhub/bilibili/huahuo/live_area_list", "/apis/v1/tikhub/bilibili/huahuo/live_commerce_info", "/apis/v1/tikhub/bilibili/huahuo/live_good_category", "/apis/v1/tikhub/bilibili/huahuo/live_guild_drop", "/apis/v1/tikhub/bilibili/huahuo/live_parent_tag", "/apis/v1/tikhub/bilibili/huahuo/live_upper_portrait", "/apis/v1/tikhub/bilibili/huahuo/mcn_drop", "/apis/v1/tikhub/bilibili/huahuo/partition_drop", "/apis/v1/tikhub/bilibili/huahuo/popular_avid_category_drop", "/apis/v1/tikhub/bilibili/huahuo/popular_avid_list", "/apis/v1/tikhub/bilibili/huahuo/popular_goods_industry_up_list", "/apis/v1/tikhub/bilibili/huahuo/popular_goods_list", "/apis/v1/tikhub/bilibili/huahuo/popular_goods_up_list", "/apis/v1/tikhub/bilibili/huahuo/popular_up_list", "/apis/v1/tikhub/bilibili/huahuo/popular_up_tid_drop", "/apis/v1/tikhub/bilibili/huahuo/popular_up_x_huo", "/apis/v1/tikhub/bilibili/huahuo/region_drop", "/apis/v1/tikhub/bilibili/huahuo/search_live_upper", "/apis/v1/tikhub/bilibili/huahuo/search_upper", "/apis/v1/tikhub/bilibili/huahuo/search_upper_suggest", "/apis/v1/tikhub/bilibili/huahuo/square_static_info", "/apis/v1/tikhub/bilibili/huahuo/tag_character", "/apis/v1/tikhub/bilibili/huahuo/tag_commercial", "/apis/v1/tikhub/bilibili/huahuo/tag_occupation", "/apis/v1/tikhub/bilibili/huahuo/upper_archive_highlights", "/apis/v1/tikhub/bilibili/huahuo/upper_base_info", "/apis/v1/tikhub/bilibili/huahuo/upper_busy_time", "/apis/v1/tikhub/bilibili/huahuo/upper_by_nickname", "/apis/v1/tikhub/bilibili/huahuo/upper_detail", "/apis/v1/tikhub/bilibili/huahuo/upper_draft_performance", "/apis/v1/tikhub/bilibili/huahuo/upper_draft_trend", "/apis/v1/tikhub/bilibili/huahuo/upper_fans_trend", "/apis/v1/tikhub/bilibili/huahuo/upper_label_tree", "/apis/v1/tikhub/bilibili/huahuo/upper_overlap_uppers", "/apis/v1/tikhub/bilibili/huahuo/upper_representative", "/apis/v1/tikhub/bilibili/huahuo/upper_seek_info", "/apis/v1/tikhub/bilibili/huahuo/upper_similar", "/apis/v1/tikhub/bilibili/huahuo/x_huo_date_options", "/apis/v1/tikhub/bilibili/huahuo/x_huo_industry_drop", "/apis/v1/tikhub/bilibili/web/bv_to_aid", "/apis/v1/tikhub/bilibili/web/fetch_all_live_areas", "/apis/v1/tikhub/bilibili/web/fetch_collect_folders", "/apis/v1/tikhub/bilibili/web/fetch_com_popular", "/apis/v1/tikhub/bilibili/web/fetch_comment_reply", "/apis/v1/tikhub/bilibili/web/fetch_dynamic_detail_v2", "/apis/v1/tikhub/bilibili/web/fetch_general_search", "/apis/v1/tikhub/bilibili/web/fetch_get_user_id", "/apis/v1/tikhub/bilibili/web/fetch_hot_search", "/apis/v1/tikhub/bilibili/web/fetch_live_room_detail", "/apis/v1/tikhub/bilibili/web/fetch_live_streamers", "/apis/v1/tikhub/bilibili/web/fetch_live_videos", "/apis/v1/tikhub/bilibili/web/fetch_one_video", "/apis/v1/tikhub/bilibili/web/fetch_user_collection_videos", "/apis/v1/tikhub/bilibili/web/fetch_user_dynamic", "/apis/v1/tikhub/bilibili/web/fetch_user_post_videos_v2", "/apis/v1/tikhub/bilibili/web/fetch_user_profile", "/apis/v1/tikhub/bilibili/web/fetch_user_relation_stat", "/apis/v1/tikhub/bilibili/web/fetch_user_up_stat", "/apis/v1/tikhub/bilibili/web/fetch_video_comments", "/apis/v1/tikhub/bilibili/web/fetch_video_danmaku", "/apis/v1/tikhub/bilibili/web/fetch_video_detail", "/apis/v1/tikhub/bilibili/web/fetch_video_parts", "/apis/v1/tikhub/bilibili/web/fetch_video_play_info", "/apis/v1/tikhub/bilibili/web/fetch_video_playurl", "/apis/v1/tikhub/bilibili/web/fetch_video_subtitle", "/apis/v1/tikhub/bilibili/web/fetch_vip_video_playurl", "/apis/v1/tikhub/douyin/app/v3/fetch_brand_hot_search_list", "/apis/v1/tikhub/douyin/app/v3/fetch_brand_hot_search_list_detail", "/apis/v1/tikhub/douyin/app/v3/fetch_hashtag_detail", "/apis/v1/tikhub/douyin/app/v3/fetch_hashtag_video_list", "/apis/v1/tikhub/douyin/app/v3/fetch_hot_search_list", "/apis/v1/tikhub/douyin/app/v3/fetch_live_hot_search_list", "/apis/v1/tikhub/douyin/app/v3/fetch_multi_video", "/apis/v1/tikhub/douyin/app/v3/fetch_multi_video_high_quality_play_url", "/apis/v1/tikhub/douyin/app/v3/fetch_multi_video_statistics", "/apis/v1/tikhub/douyin/app/v3/fetch_music_detail", "/apis/v1/tikhub/douyin/app/v3/fetch_music_hot_search_list", "/apis/v1/tikhub/douyin/app/v3/fetch_music_video_list", "/apis/v1/tikhub/douyin/app/v3/fetch_one_video", "/apis/v1/tikhub/douyin/app/v3/fetch_one_video_by_share_url", "/apis/v1/tikhub/douyin/app/v3/fetch_series_detail", "/apis/v1/tikhub/douyin/app/v3/fetch_series_video_list", "/apis/v1/tikhub/douyin/app/v3/fetch_share_info_by_share_code", "/apis/v1/tikhub/douyin/app/v3/fetch_user_fans_list", "/apis/v1/tikhub/douyin/app/v3/fetch_user_like_videos", "/apis/v1/tikhub/douyin/app/v3/fetch_user_post_videos", "/apis/v1/tikhub/douyin/app/v3/fetch_user_series_list", "/apis/v1/tikhub/douyin/app/v3/fetch_video_comment_replies", "/apis/v1/tikhub/douyin/app/v3/fetch_video_comments", "/apis/v1/tikhub/douyin/app/v3/fetch_video_high_quality_play_url", "/apis/v1/tikhub/douyin/app/v3/fetch_video_mix_detail", "/apis/v1/tikhub/douyin/app/v3/fetch_video_mix_post_list", "/apis/v1/tikhub/douyin/app/v3/fetch_video_statistics", "/apis/v1/tikhub/douyin/app/v3/generate_douyin_short_url", "/apis/v1/tikhub/douyin/app/v3/generate_douyin_video_share_qrcode", "/apis/v1/tikhub/douyin/app/v3/handler_user_profile", "/apis/v1/tikhub/douyin/app/v3/open_douyin_app_to_keyword_search", "/apis/v1/tikhub/douyin/app/v3/open_douyin_app_to_send_private_message", "/apis/v1/tikhub/douyin/app/v3/open_douyin_app_to_user_profile", "/apis/v1/tikhub/douyin/app/v3/open_douyin_app_to_video_detail", "/apis/v1/tikhub/douyin/app/v3/register_device", "/apis/v1/tikhub/douyin/billboard/fetch_city_list", "/apis/v1/tikhub/douyin/billboard/fetch_content_tag", "/apis/v1/tikhub/douyin/billboard/fetch_hot_account_fans_interest_account_list", "/apis/v1/tikhub/douyin/billboard/fetch_hot_account_fans_interest_search_list", "/apis/v1/tikhub/douyin/billboard/fetch_hot_account_fans_interest_topic_list", "/apis/v1/tikhub/douyin/billboard/fetch_hot_account_fans_portrait_list", "/apis/v1/tikhub/douyin/billboard/fetch_hot_account_item_analysis_list", "/apis/v1/tikhub/douyin/billboard/fetch_hot_account_list", "/apis/v1/tikhub/douyin/billboard/fetch_hot_account_search_list", "/apis/v1/tikhub/douyin/billboard/fetch_hot_account_trends_list", "/apis/v1/tikhub/douyin/billboard/fetch_hot_calendar_detail", "/apis/v1/tikhub/douyin/billboard/fetch_hot_calendar_list", "/apis/v1/tikhub/douyin/billboard/fetch_hot_category_list", "/apis/v1/tikhub/douyin/billboard/fetch_hot_challenge_list", "/apis/v1/tikhub/douyin/billboard/fetch_hot_city_list", "/apis/v1/tikhub/douyin/billboard/fetch_hot_comment_word_list", "/apis/v1/tikhub/douyin/billboard/fetch_hot_item_trends_list", "/apis/v1/tikhub/douyin/billboard/fetch_hot_rise_list", "/apis/v1/tikhub/douyin/billboard/fetch_hot_total_high_fan_list", "/apis/v1/tikhub/douyin/billboard/fetch_hot_total_high_like_list", "/apis/v1/tikhub/douyin/billboard/fetch_hot_total_high_play_list", "/apis/v1/tikhub/douyin/billboard/fetch_hot_total_high_search_list", "/apis/v1/tikhub/douyin/billboard/fetch_hot_total_high_topic_list", "/apis/v1/tikhub/douyin/billboard/fetch_hot_total_hot_word_detail_list", "/apis/v1/tikhub/douyin/billboard/fetch_hot_total_hot_word_list", "/apis/v1/tikhub/douyin/billboard/fetch_hot_total_list", "/apis/v1/tikhub/douyin/billboard/fetch_hot_total_low_fan_list", "/apis/v1/tikhub/douyin/billboard/fetch_hot_total_search_list", "/apis/v1/tikhub/douyin/billboard/fetch_hot_total_topic_list", "/apis/v1/tikhub/douyin/billboard/fetch_hot_total_video_list", "/apis/v1/tikhub/douyin/billboard/fetch_hot_user_portrait_list", "/apis/v1/tikhub/douyin/creator/fetch_creator_activity_detail", "/apis/v1/tikhub/douyin/creator/fetch_creator_activity_list", "/apis/v1/tikhub/douyin/creator/fetch_creator_content_category", "/apis/v1/tikhub/douyin/creator/fetch_creator_content_course", "/apis/v1/tikhub/douyin/creator/fetch_creator_hot_challenge_billboard", "/apis/v1/tikhub/douyin/creator/fetch_creator_hot_course", "/apis/v1/tikhub/douyin/creator/fetch_creator_hot_music_billboard", "/apis/v1/tikhub/douyin/creator/fetch_creator_hot_props_billboard", "/apis/v1/tikhub/douyin/creator/fetch_creator_hot_spot_billboard", "/apis/v1/tikhub/douyin/creator/fetch_creator_hot_topic_billboard", "/apis/v1/tikhub/douyin/creator/fetch_creator_material_center_billboard", "/apis/v1/tikhub/douyin/creator/fetch_creator_material_center_config", "/apis/v1/tikhub/douyin/creator/fetch_creator_material_center_related", "/apis/v1/tikhub/douyin/creator/fetch_industry_category_config", "/apis/v1/tikhub/douyin/creator/fetch_mission_task_list", "/apis/v1/tikhub/douyin/creator/fetch_user_search", "/apis/v1/tikhub/douyin/creator/fetch_video_danmaku_list", "/apis/v1/tikhub/douyin/creator_v2/fetch_author_diagnosis", "/apis/v1/tikhub/douyin/creator_v2/fetch_item_analysis_involved_vertical", "/apis/v1/tikhub/douyin/creator_v2/fetch_item_analysis_item_performance", "/apis/v1/tikhub/douyin/creator_v2/fetch_item_analysis_overview", "/apis/v1/tikhub/douyin/creator_v2/fetch_item_audience_others", "/apis/v1/tikhub/douyin/creator_v2/fetch_item_audience_portrait", "/apis/v1/tikhub/douyin/creator_v2/fetch_item_danmaku_analysis", "/apis/v1/tikhub/douyin/creator_v2/fetch_item_list", "/apis/v1/tikhub/douyin/creator_v2/fetch_item_list_download", "/apis/v1/tikhub/douyin/creator_v2/fetch_item_overview_data", "/apis/v1/tikhub/douyin/creator_v2/fetch_item_play_source", "/apis/v1/tikhub/douyin/creator_v2/fetch_item_search_keyword", "/apis/v1/tikhub/douyin/creator_v2/fetch_item_watch_trend", "/apis/v1/tikhub/douyin/creator_v2/fetch_live_room_history_list", "/apis/v1/tikhub/douyin/douplus/calculate_cost", "/apis/v1/tikhub/douyin/douplus/fetch_analyse_detail", "/apis/v1/tikhub/douyin/douplus/fetch_analyse_graph", "/apis/v1/tikhub/douyin/douplus/fetch_analyse_overview", "/apis/v1/tikhub/douyin/douplus/fetch_delivery_effect_estimate", "/apis/v1/tikhub/douyin/douplus/fetch_promotable_item_list", "/apis/v1/tikhub/douyin/douplus/fetch_promoted_accounts", "/apis/v1/tikhub/douyin/douplus/fetch_sec_token", "/apis/v1/tikhub/douyin/douplus/fetch_talent_categories", "/apis/v1/tikhub/douyin/douplus/fetch_talents_by_category", "/apis/v1/tikhub/douyin/douplus/fetch_user_posts", "/apis/v1/tikhub/douyin/douplus/fetch_video_detail", "/apis/v1/tikhub/douyin/douplus/fetch_video_ranking", "/apis/v1/tikhub/douyin/douplus/search_live_room", "/apis/v1/tikhub/douyin/douplus/search_user_v2", "/apis/v1/tikhub/douyin/douplus/search_video", "/apis/v1/tikhub/douyin/index/fetch_all_area", "/apis/v1/tikhub/douyin/index/fetch_all_valid_date", "/apis/v1/tikhub/douyin/index/fetch_brand_cycles", "/apis/v1/tikhub/douyin/index/fetch_brand_hot_videos_time_scope", "/apis/v1/tikhub/douyin/index/fetch_brand_initiative_rank_weekly", "/apis/v1/tikhub/douyin/index/fetch_brand_lines", "/apis/v1/tikhub/douyin/index/fetch_brand_radar_chart", "/apis/v1/tikhub/douyin/index/fetch_brand_suggest", "/apis/v1/tikhub/douyin/index/fetch_brand_valid_info", "/apis/v1/tikhub/douyin/index/fetch_content_author_portrait", "/apis/v1/tikhub/douyin/index/fetch_content_consume_trend", "/apis/v1/tikhub/douyin/index/fetch_content_consumer_portrait", "/apis/v1/tikhub/douyin/index/fetch_content_creative_duration", "/apis/v1/tikhub/douyin/index/fetch_content_creative_keyword_items", "/apis/v1/tikhub/douyin/index/fetch_content_creative_keywords", "/apis/v1/tikhub/douyin/index/fetch_content_creative_topic", "/apis/v1/tikhub/douyin/index/fetch_content_interact_trend", "/apis/v1/tikhub/douyin/index/fetch_content_publish_trend", "/apis/v1/tikhub/douyin/index/fetch_content_valid_date", "/apis/v1/tikhub/douyin/index/fetch_current_hot_topic", "/apis/v1/tikhub/douyin/index/fetch_daren_compare_users_stable", "/apis/v1/tikhub/douyin/index/fetch_daren_great_item_mile_info", "/apis/v1/tikhub/douyin/index/fetch_daren_great_user_fans_info", "/apis/v1/tikhub/douyin/index/fetch_daren_great_user_top_video", "/apis/v1/tikhub/douyin/index/fetch_daren_similar_users", "/apis/v1/tikhub/douyin/index/fetch_daren_sug_great_user_list", "/apis/v1/tikhub/douyin/index/fetch_encrypt_user_id", "/apis/v1/tikhub/douyin/index/fetch_get_user_sub_word", "/apis/v1/tikhub/douyin/index/fetch_hot_detail", "/apis/v1/tikhub/douyin/index/fetch_hot_trend_word", "/apis/v1/tikhub/douyin/index/fetch_hot_words", "/apis/v1/tikhub/douyin/index/fetch_insight_get_rec", "/apis/v1/tikhub/douyin/index/fetch_insight_recommend", "/apis/v1/tikhub/douyin/index/fetch_item_analysis", "/apis/v1/tikhub/douyin/index/fetch_item_base", "/apis/v1/tikhub/douyin/index/fetch_item_filter_options", "/apis/v1/tikhub/douyin/index/fetch_item_index", "/apis/v1/tikhub/douyin/index/fetch_item_index_interpret", "/apis/v1/tikhub/douyin/index/fetch_item_query", "/apis/v1/tikhub/douyin/index/fetch_item_sug", "/apis/v1/tikhub/douyin/index/fetch_item_user_profile", "/apis/v1/tikhub/douyin/index/fetch_keyword_valid_date", "/apis/v1/tikhub/douyin/index/fetch_multi_keyword_hot_trend", "/apis/v1/tikhub/douyin/index/fetch_multi_keyword_interpretation", "/apis/v1/tikhub/douyin/index/fetch_portrait", "/apis/v1/tikhub/douyin/index/fetch_relation_word", "/apis/v1/tikhub/douyin/index/fetch_report_detail", "/apis/v1/tikhub/douyin/index/fetch_report_search", "/apis/v1/tikhub/douyin/index/fetch_topic_query", "/apis/v1/tikhub/douyin/index/fetch_topic_suggest", "/apis/v1/tikhub/douyin/index/fetch_valid_date_for_relation", "/apis/v1/tikhub/douyin/search/fetch_challenge_search_v2", "/apis/v1/tikhub/douyin/search/fetch_challenge_suggest", "/apis/v1/tikhub/douyin/search/fetch_discuss_search", "/apis/v1/tikhub/douyin/search/fetch_experience_search", "/apis/v1/tikhub/douyin/search/fetch_general_search_v3", "/apis/v1/tikhub/douyin/search/fetch_image_search_v3", "/apis/v1/tikhub/douyin/search/fetch_live_search_v2", "/apis/v1/tikhub/douyin/search/fetch_multi_search", "/apis/v1/tikhub/douyin/search/fetch_music_search", "/apis/v1/tikhub/douyin/search/fetch_school_search", "/apis/v1/tikhub/douyin/search/fetch_search_suggest", "/apis/v1/tikhub/douyin/search/fetch_user_search_v2", "/apis/v1/tikhub/douyin/search/fetch_video_search_v5", "/apis/v1/tikhub/douyin/web/encrypt_uid_to_sec_user_id", "/apis/v1/tikhub/douyin/web/fetch_batch_user_profile_v2", "/apis/v1/tikhub/douyin/web/fetch_cartoon_aweme", "/apis/v1/tikhub/douyin/web/fetch_challenge_posts", "/apis/v1/tikhub/douyin/web/fetch_douyin_web_guest_cookie", "/apis/v1/tikhub/douyin/web/fetch_food_aweme", "/apis/v1/tikhub/douyin/web/fetch_game_aweme", "/apis/v1/tikhub/douyin/web/fetch_home_feed", "/apis/v1/tikhub/douyin/web/fetch_hot_search_result", "/apis/v1/tikhub/douyin/web/fetch_knowledge_aweme", "/apis/v1/tikhub/douyin/web/fetch_live_gift_ranking", "/apis/v1/tikhub/douyin/web/fetch_live_im_fetch", "/apis/v1/tikhub/douyin/web/fetch_multi_video", "/apis/v1/tikhub/douyin/web/fetch_multi_video_high_quality_play_url", "/apis/v1/tikhub/douyin/web/fetch_music_aweme", "/apis/v1/tikhub/douyin/web/fetch_one_video", "/apis/v1/tikhub/douyin/web/fetch_one_video_by_share_url", "/apis/v1/tikhub/douyin/web/fetch_one_video_danmaku", "/apis/v1/tikhub/douyin/web/fetch_query_user", "/apis/v1/tikhub/douyin/web/fetch_related_posts", "/apis/v1/tikhub/douyin/web/fetch_series_aweme", "/apis/v1/tikhub/douyin/web/fetch_user_collection_videos", "/apis/v1/tikhub/douyin/web/fetch_user_collects", "/apis/v1/tikhub/douyin/web/fetch_user_collects_videos", "/apis/v1/tikhub/douyin/web/fetch_user_fans_list", "/apis/v1/tikhub/douyin/web/fetch_user_following_list", "/apis/v1/tikhub/douyin/web/fetch_user_like_videos", "/apis/v1/tikhub/douyin/web/fetch_user_live_info_by_uid", "/apis/v1/tikhub/douyin/web/fetch_user_live_videos", "/apis/v1/tikhub/douyin/web/fetch_user_live_videos_by_room_id_v2", "/apis/v1/tikhub/douyin/web/fetch_user_live_videos_by_sec_uid", "/apis/v1/tikhub/douyin/web/fetch_user_mix_videos", "/apis/v1/tikhub/douyin/web/fetch_user_post_videos", "/apis/v1/tikhub/douyin/web/fetch_user_profile_by_short_id", "/apis/v1/tikhub/douyin/web/fetch_user_profile_by_uid", "/apis/v1/tikhub/douyin/web/fetch_video_channel_result", "/apis/v1/tikhub/douyin/web/fetch_video_comment_replies", "/apis/v1/tikhub/douyin/web/fetch_video_comments", "/apis/v1/tikhub/douyin/web/fetch_video_high_quality_play_url", "/apis/v1/tikhub/douyin/web/generate_ttwid", "/apis/v1/tikhub/douyin/web/generate_wss_xb_signature", "/apis/v1/tikhub/douyin/web/get_all_aweme_id", "/apis/v1/tikhub/douyin/web/get_all_sec_user_id", "/apis/v1/tikhub/douyin/web/get_all_webcast_id", "/apis/v1/tikhub/douyin/web/get_aweme_id", "/apis/v1/tikhub/douyin/web/get_sec_user_id", "/apis/v1/tikhub/douyin/web/get_webcast_id", "/apis/v1/tikhub/douyin/web/handler_shorten_url", "/apis/v1/tikhub/douyin/web/handler_user_profile", "/apis/v1/tikhub/douyin/web/webcast_id_2_room_id", "/apis/v1/tikhub/douyin/xingtu/author_content_hot_comment_keywords_v1", "/apis/v1/tikhub/douyin/xingtu/author_hot_comment_tokens_v1", "/apis/v1/tikhub/douyin/xingtu/get_sign_image", "/apis/v1/tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id", "/apis/v1/tikhub/douyin/xingtu/get_xingtu_kolid_by_uid", "/apis/v1/tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id", "/apis/v1/tikhub/douyin/xingtu/kol_audience_portrait_v1", "/apis/v1/tikhub/douyin/xingtu/kol_base_info_v1", "/apis/v1/tikhub/douyin/xingtu/kol_conversion_ability_analysis_v1", "/apis/v1/tikhub/douyin/xingtu/kol_convert_video_display_v1", "/apis/v1/tikhub/douyin/xingtu/kol_cp_info_v1", "/apis/v1/tikhub/douyin/xingtu/kol_daily_fans_v1", "/apis/v1/tikhub/douyin/xingtu/kol_data_overview_v1", "/apis/v1/tikhub/douyin/xingtu/kol_fans_portrait_v1", "/apis/v1/tikhub/douyin/xingtu/kol_link_struct_v1", "/apis/v1/tikhub/douyin/xingtu/kol_rec_videos_v1", "/apis/v1/tikhub/douyin/xingtu/kol_service_price_v1", "/apis/v1/tikhub/douyin/xingtu/kol_touch_distribution_v1", "/apis/v1/tikhub/douyin/xingtu/kol_video_performance_v1", "/apis/v1/tikhub/douyin/xingtu/kol_xingtu_index_v1", "/apis/v1/tikhub/douyin/xingtu/search_kol_v2", "/apis/v1/tikhub/douyin/xingtu_v2/get_author_audience_distribution", "/apis/v1/tikhub/douyin/xingtu_v2/get_author_base_info", "/apis/v1/tikhub/douyin/xingtu_v2/get_author_business_card_info", "/apis/v1/tikhub/douyin/xingtu_v2/get_author_commerce_spread_info", "/apis/v1/tikhub/douyin/xingtu_v2/get_author_content_hot_keywords", "/apis/v1/tikhub/douyin/xingtu_v2/get_author_convert_ability", "/apis/v1/tikhub/douyin/xingtu_v2/get_author_convert_videos_or_products", "/apis/v1/tikhub/douyin/xingtu_v2/get_author_cp_info", "/apis/v1/tikhub/douyin/xingtu_v2/get_author_daily_fans", "/apis/v1/tikhub/douyin/xingtu_v2/get_author_daily_link", "/apis/v1/tikhub/douyin/xingtu_v2/get_author_daily_link_score", "/apis/v1/tikhub/douyin/xingtu_v2/get_author_fans_distribution", "/apis/v1/tikhub/douyin/xingtu_v2/get_author_homepage_videos", "/apis/v1/tikhub/douyin/xingtu_v2/get_author_hot_comment_tokens", "/apis/v1/tikhub/douyin/xingtu_v2/get_author_link_info", "/apis/v1/tikhub/douyin/xingtu_v2/get_author_local_info", "/apis/v1/tikhub/douyin/xingtu_v2/get_author_market_fields", "/apis/v1/tikhub/douyin/xingtu_v2/get_author_rec_videos_v2", "/apis/v1/tikhub/douyin/xingtu_v2/get_author_show_items", "/apis/v1/tikhub/douyin/xingtu_v2/get_author_spread_info", "/apis/v1/tikhub/douyin/xingtu_v2/get_author_spread_videos", "/apis/v1/tikhub/douyin/xingtu_v2/get_author_touch_distribution", "/apis/v1/tikhub/douyin/xingtu_v2/get_author_video_distribution", "/apis/v1/tikhub/douyin/xingtu_v2/get_content_trend_guide", "/apis/v1/tikhub/douyin/xingtu_v2/get_demander_mcn_list", "/apis/v1/tikhub/douyin/xingtu_v2/get_excellent_case_category_list", "/apis/v1/tikhub/douyin/xingtu_v2/get_ip_activity_detail", "/apis/v1/tikhub/douyin/xingtu_v2/get_ip_activity_industry_list", "/apis/v1/tikhub/douyin/xingtu_v2/get_ip_activity_list", "/apis/v1/tikhub/douyin/xingtu_v2/get_item_play_count", "/apis/v1/tikhub/douyin/xingtu_v2/get_item_report_comments", "/apis/v1/tikhub/douyin/xingtu_v2/get_item_report_detail", "/apis/v1/tikhub/douyin/xingtu_v2/get_item_report_th_analysis", "/apis/v1/tikhub/douyin/xingtu_v2/get_item_report_trend", "/apis/v1/tikhub/douyin/xingtu_v2/get_playlet_actor_rank_catalog", "/apis/v1/tikhub/douyin/xingtu_v2/get_playlet_actor_rank_list", "/apis/v1/tikhub/douyin/xingtu_v2/get_ranking_list_catalog", "/apis/v1/tikhub/douyin/xingtu_v2/get_ranking_list_data", "/apis/v1/tikhub/douyin/xingtu_v2/get_recommend_for_star_authors", "/apis/v1/tikhub/douyin/xingtu_v2/get_resource_list", "/apis/v1/tikhub/douyin/xingtu_v2/get_search_field_options", "/apis/v1/tikhub/douyin/xingtu_v2/get_user_profile_qrcode", "/apis/v1/tikhub/douyin/xingtu_v2/get_xingtu_kolid_by_sec_user_id", "/apis/v1/tikhub/douyin/xingtu_v2/get_xingtu_kolid_by_uid", "/apis/v1/tikhub/douyin/xingtu_v2/get_xingtu_kolid_by_unique_id", "/apis/v1/tikhub/douyin/xingtu_v2/multi_get_author_info", "/apis/v1/tikhub/douyin/xingtu_v2/multi_get_item_stats", "/apis/v1/tikhub/douyin/xingtu_v2/search_anchor", "/apis/v1/tikhub/douyin/xingtu_v2/search_creator", "/apis/v1/tikhub/douyin/xingtu_v2/search_toutiao_creator", "/apis/v1/tikhub/hybrid/video_data", "/apis/v1/tikhub/instagram/v1/fetch_cities", "/apis/v1/tikhub/instagram/v1/fetch_explore_sections", "/apis/v1/tikhub/instagram/v1/fetch_location_info", "/apis/v1/tikhub/instagram/v1/fetch_locations", "/apis/v1/tikhub/instagram/v1/fetch_post_by_id", "/apis/v1/tikhub/instagram/v1/fetch_post_by_url", "/apis/v1/tikhub/instagram/v1/fetch_related_profiles", "/apis/v1/tikhub/instagram/v1/fetch_search", "/apis/v1/tikhub/instagram/v1/fetch_section_posts", "/apis/v1/tikhub/instagram/v1/fetch_user_about_info", "/apis/v1/tikhub/instagram/v1/fetch_user_info_by_id", "/apis/v1/tikhub/instagram/v1/fetch_user_info_by_username", "/apis/v1/tikhub/instagram/v1/fetch_user_reposts", "/apis/v1/tikhub/instagram/v2/fetch_comment_replies", "/apis/v1/tikhub/instagram/v2/fetch_hashtag_posts", "/apis/v1/tikhub/instagram/v2/fetch_highlight_stories", "/apis/v1/tikhub/instagram/v2/fetch_location_posts", "/apis/v1/tikhub/instagram/v2/fetch_music_posts", "/apis/v1/tikhub/instagram/v2/fetch_post_comments", "/apis/v1/tikhub/instagram/v2/fetch_post_info", "/apis/v1/tikhub/instagram/v2/fetch_post_likes", "/apis/v1/tikhub/instagram/v2/fetch_similar_users", "/apis/v1/tikhub/instagram/v2/fetch_user_followers", "/apis/v1/tikhub/instagram/v2/fetch_user_following", "/apis/v1/tikhub/instagram/v2/fetch_user_highlights", "/apis/v1/tikhub/instagram/v2/fetch_user_info", "/apis/v1/tikhub/instagram/v2/fetch_user_posts", "/apis/v1/tikhub/instagram/v2/fetch_user_reels", "/apis/v1/tikhub/instagram/v2/fetch_user_stories", "/apis/v1/tikhub/instagram/v2/fetch_user_tagged_posts", "/apis/v1/tikhub/instagram/v2/search_locations", "/apis/v1/tikhub/instagram/v2/search_music", "/apis/v1/tikhub/instagram/v2/search_reels", "/apis/v1/tikhub/instagram/v3/bulk_translate_comments", "/apis/v1/tikhub/instagram/v3/extract_shortcode", "/apis/v1/tikhub/instagram/v3/general_search", "/apis/v1/tikhub/instagram/v3/get_comment_replies", "/apis/v1/tikhub/instagram/v3/get_explore", "/apis/v1/tikhub/instagram/v3/get_hashtag_posts", "/apis/v1/tikhub/instagram/v3/get_highlight_stories", "/apis/v1/tikhub/instagram/v3/get_location_info", "/apis/v1/tikhub/instagram/v3/get_location_nearby", "/apis/v1/tikhub/instagram/v3/get_location_posts", "/apis/v1/tikhub/instagram/v3/get_music_posts", "/apis/v1/tikhub/instagram/v3/get_post_comments", "/apis/v1/tikhub/instagram/v3/get_post_info", "/apis/v1/tikhub/instagram/v3/get_post_info_by_code", "/apis/v1/tikhub/instagram/v3/get_post_likes", "/apis/v1/tikhub/instagram/v3/get_post_oembed", "/apis/v1/tikhub/instagram/v3/get_recommended_reels", "/apis/v1/tikhub/instagram/v3/get_similar_users", "/apis/v1/tikhub/instagram/v3/get_user_about", "/apis/v1/tikhub/instagram/v3/get_user_brief", "/apis/v1/tikhub/instagram/v3/get_user_followers", "/apis/v1/tikhub/instagram/v3/get_user_following", "/apis/v1/tikhub/instagram/v3/get_user_former_usernames", "/apis/v1/tikhub/instagram/v3/get_user_highlights", "/apis/v1/tikhub/instagram/v3/get_user_id_by_username", "/apis/v1/tikhub/instagram/v3/get_user_posts", "/apis/v1/tikhub/instagram/v3/get_user_profile", "/apis/v1/tikhub/instagram/v3/get_user_reels", "/apis/v1/tikhub/instagram/v3/get_user_stories", "/apis/v1/tikhub/instagram/v3/get_user_tagged_posts", "/apis/v1/tikhub/instagram/v3/media_id_to_shortcode", "/apis/v1/tikhub/instagram/v3/search_by_coordinates", "/apis/v1/tikhub/instagram/v3/search_hashtags", "/apis/v1/tikhub/instagram/v3/search_users", "/apis/v1/tikhub/instagram/v3/shortcode_to_media_id", "/apis/v1/tikhub/instagram/v3/translate_comment", "/apis/v1/tikhub/instagram/v3/user_id_to_username", "/apis/v1/tikhub/kuaishou/app/fetch_brand_top_list", "/apis/v1/tikhub/kuaishou/app/fetch_hot_board_categories", "/apis/v1/tikhub/kuaishou/app/fetch_hot_board_detail", "/apis/v1/tikhub/kuaishou/app/fetch_hot_search_person", "/apis/v1/tikhub/kuaishou/app/fetch_live_top_list", "/apis/v1/tikhub/kuaishou/app/fetch_music_ranking", "/apis/v1/tikhub/kuaishou/app/fetch_one_user_v2", "/apis/v1/tikhub/kuaishou/app/fetch_one_video", "/apis/v1/tikhub/kuaishou/app/fetch_one_video_by_url", "/apis/v1/tikhub/kuaishou/app/fetch_selection_feed", "/apis/v1/tikhub/kuaishou/app/fetch_shopping_top_list", "/apis/v1/tikhub/kuaishou/app/fetch_tag_feed", "/apis/v1/tikhub/kuaishou/app/fetch_user_hot_post", "/apis/v1/tikhub/kuaishou/app/fetch_user_live_info", "/apis/v1/tikhub/kuaishou/app/fetch_user_post_v2", "/apis/v1/tikhub/kuaishou/app/fetch_video_comment", "/apis/v1/tikhub/kuaishou/app/fetch_video_sub_comments", "/apis/v1/tikhub/kuaishou/app/fetch_videos_batch", "/apis/v1/tikhub/kuaishou/app/generate_kuaishou_share_link", "/apis/v1/tikhub/kuaishou/app/search_comprehensive", "/apis/v1/tikhub/kuaishou/app/search_image", "/apis/v1/tikhub/kuaishou/app/search_live", "/apis/v1/tikhub/kuaishou/app/search_music", "/apis/v1/tikhub/kuaishou/app/search_tag", "/apis/v1/tikhub/kuaishou/app/search_user_v2", "/apis/v1/tikhub/kuaishou/app/search_video_v2", "/apis/v1/tikhub/kuaishou/web/fetch_get_user_id", "/apis/v1/tikhub/kuaishou/web/fetch_kuaishou_hot_list_v2", "/apis/v1/tikhub/kuaishou/web/fetch_one_video", "/apis/v1/tikhub/kuaishou/web/fetch_one_video_by_url", "/apis/v1/tikhub/kuaishou/web/fetch_one_video_comment", "/apis/v1/tikhub/kuaishou/web/fetch_one_video_sub_comment", "/apis/v1/tikhub/kuaishou/web/fetch_user_collect", "/apis/v1/tikhub/kuaishou/web/fetch_user_info", "/apis/v1/tikhub/kuaishou/web/fetch_user_live_replay", "/apis/v1/tikhub/kuaishou/web/generate_share_short_url", "/apis/v1/tikhub/lemon8/app/fetch_discover_banners", "/apis/v1/tikhub/lemon8/app/fetch_discover_tab", "/apis/v1/tikhub/lemon8/app/fetch_discover_tab_information_tabs", "/apis/v1/tikhub/lemon8/app/fetch_hot_search_keywords", "/apis/v1/tikhub/lemon8/app/fetch_post_comment_list", "/apis/v1/tikhub/lemon8/app/fetch_post_detail", "/apis/v1/tikhub/lemon8/app/fetch_search", "/apis/v1/tikhub/lemon8/app/fetch_topic_info", "/apis/v1/tikhub/lemon8/app/fetch_topic_post_list", "/apis/v1/tikhub/lemon8/app/fetch_user_follower_list", "/apis/v1/tikhub/lemon8/app/fetch_user_following_list", "/apis/v1/tikhub/lemon8/app/fetch_user_profile", "/apis/v1/tikhub/lemon8/app/get_item_id", "/apis/v1/tikhub/lemon8/app/get_item_ids", "/apis/v1/tikhub/lemon8/app/get_user_id", "/apis/v1/tikhub/lemon8/app/get_user_ids", "/apis/v1/tikhub/linkedin/web_v2/get_company_posts", "/apis/v1/tikhub/linkedin/web_v2/get_company_profile", "/apis/v1/tikhub/linkedin/web_v2/get_job_detail", "/apis/v1/tikhub/linkedin/web_v2/get_post_comments", "/apis/v1/tikhub/linkedin/web_v2/get_post_detail", "/apis/v1/tikhub/linkedin/web_v2/get_user_posts", "/apis/v1/tikhub/linkedin/web_v2/get_user_profile", "/apis/v1/tikhub/linkedin/web_v2/search_jobs", "/apis/v1/tikhub/pipixia/app/fetch_hashtag_detail", "/apis/v1/tikhub/pipixia/app/fetch_hashtag_post_list", "/apis/v1/tikhub/pipixia/app/fetch_home_feed", "/apis/v1/tikhub/pipixia/app/fetch_home_short_drama_feed", "/apis/v1/tikhub/pipixia/app/fetch_hot_search_board_detail", "/apis/v1/tikhub/pipixia/app/fetch_hot_search_board_list", "/apis/v1/tikhub/pipixia/app/fetch_hot_search_words", "/apis/v1/tikhub/pipixia/app/fetch_increase_post_view_count", "/apis/v1/tikhub/pipixia/app/fetch_post_comment_list", "/apis/v1/tikhub/pipixia/app/fetch_post_detail", "/apis/v1/tikhub/pipixia/app/fetch_post_statistics", "/apis/v1/tikhub/pipixia/app/fetch_search", "/apis/v1/tikhub/pipixia/app/fetch_short_url", "/apis/v1/tikhub/pipixia/app/fetch_user_follower_list", "/apis/v1/tikhub/pipixia/app/fetch_user_following_list", "/apis/v1/tikhub/pipixia/app/fetch_user_info", "/apis/v1/tikhub/pipixia/app/fetch_user_post_list", "/apis/v1/tikhub/reddit/app/check_subreddit_muted", "/apis/v1/tikhub/reddit/app/fetch_comment_replies", "/apis/v1/tikhub/reddit/app/fetch_community_highlights", "/apis/v1/tikhub/reddit/app/fetch_dynamic_search", "/apis/v1/tikhub/reddit/app/fetch_explore_feed", "/apis/v1/tikhub/reddit/app/fetch_games_feed", "/apis/v1/tikhub/reddit/app/fetch_generated_comments", "/apis/v1/tikhub/reddit/app/fetch_generated_posts", "/apis/v1/tikhub/reddit/app/fetch_home_feed", "/apis/v1/tikhub/reddit/app/fetch_news_feed", "/apis/v1/tikhub/reddit/app/fetch_popular_feed", "/apis/v1/tikhub/reddit/app/fetch_post_comments", "/apis/v1/tikhub/reddit/app/fetch_post_details", "/apis/v1/tikhub/reddit/app/fetch_post_details_batch", "/apis/v1/tikhub/reddit/app/fetch_post_details_batch_large", "/apis/v1/tikhub/reddit/app/fetch_search_typeahead", "/apis/v1/tikhub/reddit/app/fetch_subreddit_feed", "/apis/v1/tikhub/reddit/app/fetch_subreddit_info", "/apis/v1/tikhub/reddit/app/fetch_subreddit_post_channels", "/apis/v1/tikhub/reddit/app/fetch_subreddit_settings", "/apis/v1/tikhub/reddit/app/fetch_subreddit_style", "/apis/v1/tikhub/reddit/app/fetch_topic_feed", "/apis/v1/tikhub/reddit/app/fetch_trending_searches", "/apis/v1/tikhub/reddit/app/fetch_user_active_subreddits", "/apis/v1/tikhub/reddit/app/fetch_user_comments", "/apis/v1/tikhub/reddit/app/fetch_user_posts", "/apis/v1/tikhub/reddit/app/fetch_user_profile", "/apis/v1/tikhub/reddit/app/fetch_user_trophies", "/apis/v1/tikhub/telegram/web/batch_channel_info", "/apis/v1/tikhub/telegram/web/fetch_channel_info", "/apis/v1/tikhub/telegram/web/fetch_channel_posts", "/apis/v1/tikhub/telegram/web/fetch_channel_search", "/apis/v1/tikhub/telegram/web/fetch_post_comments", "/apis/v1/tikhub/telegram/web/fetch_post_detail", "/apis/v1/tikhub/telegram/web/fetch_similar_channels", "/apis/v1/tikhub/threads/web/fetch_post_comments", "/apis/v1/tikhub/threads/web/fetch_post_detail", "/apis/v1/tikhub/threads/web/fetch_user_info", "/apis/v1/tikhub/threads/web/fetch_user_info_by_id", "/apis/v1/tikhub/threads/web/fetch_user_posts", "/apis/v1/tikhub/threads/web/fetch_user_replies", "/apis/v1/tikhub/threads/web/fetch_user_reposts", "/apis/v1/tikhub/threads/web/search_profiles", "/apis/v1/tikhub/tiktok/ads/get_ad_interactive_analysis", "/apis/v1/tikhub/tiktok/ads/get_ad_keyframe_analysis", "/apis/v1/tikhub/tiktok/ads/get_ad_percentile", "/apis/v1/tikhub/tiktok/ads/get_ads_detail", "/apis/v1/tikhub/tiktok/ads/get_configure_safety", "/apis/v1/tikhub/tiktok/ads/get_creators_card", "/apis/v1/tikhub/tiktok/ads/get_location_list", "/apis/v1/tikhub/tiktok/ads/get_query_suggestions", "/apis/v1/tikhub/tiktok/ads/get_recommended_ads", "/apis/v1/tikhub/tiktok/ads/get_top_ads_filters", "/apis/v1/tikhub/tiktok/ads/get_top_ads_spotlight", "/apis/v1/tikhub/tiktok/ads/get_top_contents_item_detail", "/apis/v1/tikhub/tiktok/ads/get_top_contents_list", "/apis/v1/tikhub/tiktok/ads/get_trends_hashtag_detail", "/apis/v1/tikhub/tiktok/ads/get_trends_hashtag_list", "/apis/v1/tikhub/tiktok/ads/search_ads", "/apis/v1/tikhub/tiktok/analytics/detect_fake_views", "/apis/v1/tikhub/tiktok/analytics/fetch_comment_keywords", "/apis/v1/tikhub/tiktok/analytics/fetch_creator_info_and_milestones", "/apis/v1/tikhub/tiktok/analytics/fetch_video_metrics", "/apis/v1/tikhub/tiktok/app/v3/TTencrypt_algorithm", "/apis/v1/tikhub/tiktok/app/v3/check_live_room_online", "/apis/v1/tikhub/tiktok/app/v3/check_live_room_online_batch", "/apis/v1/tikhub/tiktok/app/v3/encrypt_decrypt_login_request", "/apis/v1/tikhub/tiktok/app/v3/fetch_content_translate", "/apis/v1/tikhub/tiktok/app/v3/fetch_creator_info", "/apis/v1/tikhub/tiktok/app/v3/fetch_creator_search_insights", "/apis/v1/tikhub/tiktok/app/v3/fetch_creator_search_insights_detail", "/apis/v1/tikhub/tiktok/app/v3/fetch_creator_search_insights_trend", "/apis/v1/tikhub/tiktok/app/v3/fetch_creator_search_insights_videos", "/apis/v1/tikhub/tiktok/app/v3/fetch_general_search_result", "/apis/v1/tikhub/tiktok/app/v3/fetch_hashtag_detail", "/apis/v1/tikhub/tiktok/app/v3/fetch_hashtag_search_result", "/apis/v1/tikhub/tiktok/app/v3/fetch_hashtag_video_list", "/apis/v1/tikhub/tiktok/app/v3/fetch_home_feed", "/apis/v1/tikhub/tiktok/app/v3/fetch_live_daily_rank", "/apis/v1/tikhub/tiktok/app/v3/fetch_live_ranking_list", "/apis/v1/tikhub/tiktok/app/v3/fetch_live_room_info", "/apis/v1/tikhub/tiktok/app/v3/fetch_live_room_product_list", "/apis/v1/tikhub/tiktok/app/v3/fetch_live_search_result", "/apis/v1/tikhub/tiktok/app/v3/fetch_location_search", "/apis/v1/tikhub/tiktok/app/v3/fetch_multi_video", "/apis/v1/tikhub/tiktok/app/v3/fetch_music_chart_list", "/apis/v1/tikhub/tiktok/app/v3/fetch_music_detail", "/apis/v1/tikhub/tiktok/app/v3/fetch_music_search_result", "/apis/v1/tikhub/tiktok/app/v3/fetch_music_video_list", "/apis/v1/tikhub/tiktok/app/v3/fetch_one_video", "/apis/v1/tikhub/tiktok/app/v3/fetch_one_video_by_share_url_v2", "/apis/v1/tikhub/tiktok/app/v3/fetch_share_qr_code", "/apis/v1/tikhub/tiktok/app/v3/fetch_share_short_link", "/apis/v1/tikhub/tiktok/app/v3/fetch_similar_user_recommendations", "/apis/v1/tikhub/tiktok/app/v3/fetch_user_country_by_username", "/apis/v1/tikhub/tiktok/app/v3/fetch_user_follower_list", "/apis/v1/tikhub/tiktok/app/v3/fetch_user_following_list", "/apis/v1/tikhub/tiktok/app/v3/fetch_user_like_videos", "/apis/v1/tikhub/tiktok/app/v3/fetch_user_music_list", "/apis/v1/tikhub/tiktok/app/v3/fetch_user_post_videos", "/apis/v1/tikhub/tiktok/app/v3/fetch_user_repost_videos", "/apis/v1/tikhub/tiktok/app/v3/fetch_user_search_result", "/apis/v1/tikhub/tiktok/app/v3/fetch_video_comment_replies", "/apis/v1/tikhub/tiktok/app/v3/fetch_video_comments", "/apis/v1/tikhub/tiktok/app/v3/fetch_video_search_result", "/apis/v1/tikhub/tiktok/app/v3/fetch_webcast_user_info", "/apis/v1/tikhub/tiktok/app/v3/get_user_id_and_sec_user_id_by_username", "/apis/v1/tikhub/tiktok/app/v3/handler_user_profile", "/apis/v1/tikhub/tiktok/app/v3/open_tiktok_app_to_keyword_search", "/apis/v1/tikhub/tiktok/app/v3/open_tiktok_app_to_send_private_message", "/apis/v1/tikhub/tiktok/app/v3/open_tiktok_app_to_user_profile", "/apis/v1/tikhub/tiktok/app/v3/open_tiktok_app_to_video_detail", "/apis/v1/tikhub/tiktok/app/v3/search_follower_list", "/apis/v1/tikhub/tiktok/app/v3/search_following_list", "/apis/v1/tikhub/tiktok/creator/get_account_health_status", "/apis/v1/tikhub/tiktok/creator/get_account_insights_overview", "/apis/v1/tikhub/tiktok/creator/get_account_violation_list", "/apis/v1/tikhub/tiktok/creator/get_creator_account_info", "/apis/v1/tikhub/tiktok/creator/get_live_analytics_summary", "/apis/v1/tikhub/tiktok/creator/get_product_analytics_list", "/apis/v1/tikhub/tiktok/creator/get_product_related_videos", "/apis/v1/tikhub/tiktok/creator/get_showcase_product_list", "/apis/v1/tikhub/tiktok/creator/get_video_analytics_summary", "/apis/v1/tikhub/tiktok/creator/get_video_associated_product_list", "/apis/v1/tikhub/tiktok/creator/get_video_audience_stats", "/apis/v1/tikhub/tiktok/creator/get_video_detailed_stats", "/apis/v1/tikhub/tiktok/creator/get_video_list_analytics", "/apis/v1/tikhub/tiktok/creator/get_video_to_product_stats", "/apis/v1/tikhub/tiktok/shop/web/fetch_hot_selling_products_list", "/apis/v1/tikhub/tiktok/shop/web/fetch_product_detail_v3", "/apis/v1/tikhub/tiktok/shop/web/fetch_product_id_by_share_link", "/apis/v1/tikhub/tiktok/shop/web/fetch_product_reviews_v2", "/apis/v1/tikhub/tiktok/shop/web/fetch_products_by_category_id", "/apis/v1/tikhub/tiktok/shop/web/fetch_products_category_list", "/apis/v1/tikhub/tiktok/shop/web/fetch_search_products_list_v2", "/apis/v1/tikhub/tiktok/shop/web/fetch_search_word_suggestion_v2", "/apis/v1/tikhub/tiktok/shop/web/fetch_seller_products_list_v2", "/apis/v1/tikhub/tiktok/shop/web/fetch_shop_id_by_share_link", "/apis/v1/tikhub/tiktok/web/decrypt_strData", "/apis/v1/tikhub/tiktok/web/device_register", "/apis/v1/tikhub/tiktok/web/encrypt_strData", "/apis/v1/tikhub/tiktok/web/fetch_batch_check_live_alive", "/apis/v1/tikhub/tiktok/web/fetch_check_live_alive", "/apis/v1/tikhub/tiktok/web/fetch_explore_post", "/apis/v1/tikhub/tiktok/web/fetch_general_search", "/apis/v1/tikhub/tiktok/web/fetch_gift_name_by_id", "/apis/v1/tikhub/tiktok/web/fetch_gift_names_by_ids", "/apis/v1/tikhub/tiktok/web/fetch_home_feed", "/apis/v1/tikhub/tiktok/web/fetch_live_gift_list", "/apis/v1/tikhub/tiktok/web/fetch_live_im_fetch", "/apis/v1/tikhub/tiktok/web/fetch_live_recommend", "/apis/v1/tikhub/tiktok/web/fetch_live_recommend_tabs", "/apis/v1/tikhub/tiktok/web/fetch_post_ai_article", "/apis/v1/tikhub/tiktok/web/fetch_post_comment", "/apis/v1/tikhub/tiktok/web/fetch_post_comment_reply", "/apis/v1/tikhub/tiktok/web/fetch_post_detail_v2", "/apis/v1/tikhub/tiktok/web/fetch_search_keyword_suggest", "/apis/v1/tikhub/tiktok/web/fetch_search_live", "/apis/v1/tikhub/tiktok/web/fetch_search_photo", "/apis/v1/tikhub/tiktok/web/fetch_search_user", "/apis/v1/tikhub/tiktok/web/fetch_search_video", "/apis/v1/tikhub/tiktok/web/fetch_tag_detail", "/apis/v1/tikhub/tiktok/web/fetch_tag_post", "/apis/v1/tikhub/tiktok/web/fetch_tiktok_live_data", "/apis/v1/tikhub/tiktok/web/fetch_tiktok_web_guest_cookie", "/apis/v1/tikhub/tiktok/web/fetch_trending_searchwords", "/apis/v1/tikhub/tiktok/web/fetch_user_collect", "/apis/v1/tikhub/tiktok/web/fetch_user_fans", "/apis/v1/tikhub/tiktok/web/fetch_user_follow", "/apis/v1/tikhub/tiktok/web/fetch_user_like", "/apis/v1/tikhub/tiktok/web/fetch_user_live_detail", "/apis/v1/tikhub/tiktok/web/fetch_user_mix", "/apis/v1/tikhub/tiktok/web/fetch_user_play_list", "/apis/v1/tikhub/tiktok/web/fetch_user_post", "/apis/v1/tikhub/tiktok/web/fetch_user_profile", "/apis/v1/tikhub/tiktok/web/fetch_user_repost", "/apis/v1/tikhub/tiktok/web/generate_fingerprint", "/apis/v1/tikhub/tiktok/web/generate_hashed_id", "/apis/v1/tikhub/tiktok/web/generate_real_msToken", "/apis/v1/tikhub/tiktok/web/generate_ttwid", "/apis/v1/tikhub/tiktok/web/generate_webid", "/apis/v1/tikhub/tiktok/web/generate_wss_xb_signature", "/apis/v1/tikhub/tiktok/web/generate_x_mssdk_info", "/apis/v1/tikhub/tiktok/web/generate_xbogus", "/apis/v1/tikhub/tiktok/web/generate_xgnarly", "/apis/v1/tikhub/tiktok/web/generate_xgnarly_and_xbogus", "/apis/v1/tikhub/tiktok/web/get_all_aweme_id", "/apis/v1/tikhub/tiktok/web/get_all_sec_user_id", "/apis/v1/tikhub/tiktok/web/get_all_unique_id", "/apis/v1/tikhub/tiktok/web/get_aweme_id", "/apis/v1/tikhub/tiktok/web/get_live_room_id", "/apis/v1/tikhub/tiktok/web/get_sec_user_id", "/apis/v1/tikhub/tiktok/web/get_unique_id", "/apis/v1/tikhub/tiktok/web/get_user_id", "/apis/v1/tikhub/tiktok/web/tiktok_live_room", "/apis/v1/tikhub/toutiao/app/get_article_info", "/apis/v1/tikhub/toutiao/app/get_comments", "/apis/v1/tikhub/toutiao/app/get_user_id", "/apis/v1/tikhub/toutiao/app/get_user_info", "/apis/v1/tikhub/toutiao/app/get_video_info", "/apis/v1/tikhub/toutiao/web/get_article_info", "/apis/v1/tikhub/toutiao/web/get_video_info", "/apis/v1/tikhub/twitter/web/fetch_check_follow", "/apis/v1/tikhub/twitter/web/fetch_check_retweet", "/apis/v1/tikhub/twitter/web/fetch_community_info", "/apis/v1/tikhub/twitter/web/fetch_community_members", "/apis/v1/tikhub/twitter/web/fetch_community_timeline", "/apis/v1/tikhub/twitter/web/fetch_latest_post_comments", "/apis/v1/tikhub/twitter/web/fetch_list_followers", "/apis/v1/tikhub/twitter/web/fetch_list_members", "/apis/v1/tikhub/twitter/web/fetch_list_timeline", "/apis/v1/tikhub/twitter/web/fetch_post_comments", "/apis/v1/tikhub/twitter/web/fetch_retweet_user_list", "/apis/v1/tikhub/twitter/web/fetch_search_communities", "/apis/v1/tikhub/twitter/web/fetch_search_timeline", "/apis/v1/tikhub/twitter/web/fetch_trending", "/apis/v1/tikhub/twitter/web/fetch_tweet_detail", "/apis/v1/tikhub/twitter/web/fetch_user_about", "/apis/v1/tikhub/twitter/web/fetch_user_affiliates", "/apis/v1/tikhub/twitter/web/fetch_user_followers", "/apis/v1/tikhub/twitter/web/fetch_user_followings", "/apis/v1/tikhub/twitter/web/fetch_user_live_status", "/apis/v1/tikhub/twitter/web/fetch_user_media", "/apis/v1/tikhub/twitter/web/fetch_user_post_tweet", "/apis/v1/tikhub/twitter/web/fetch_user_profile", "/apis/v1/tikhub/twitter/web/fetch_user_profiles_by_rest_ids", "/apis/v1/tikhub/twitter/web/fetch_user_tweet_replies", "/apis/v1/tikhub/wechat_channels/v2/fetch_channel_id_to_username", "/apis/v1/tikhub/wechat_channels/v2/fetch_channel_info", "/apis/v1/tikhub/wechat_channels/v2/fetch_collection_videos", "/apis/v1/tikhub/wechat_channels/v2/fetch_live_detail", "/apis/v1/tikhub/wechat_channels/v2/fetch_live_history", "/apis/v1/tikhub/wechat_channels/v2/fetch_search_channel_videos", "/apis/v1/tikhub/wechat_channels/v2/fetch_user_collections", "/apis/v1/tikhub/wechat_channels/v2/fetch_user_profile", "/apis/v1/tikhub/wechat_channels/v2/fetch_user_videos", "/apis/v1/tikhub/wechat_channels/v2/fetch_video_comments", "/apis/v1/tikhub/wechat_channels/v2/fetch_video_detail", "/apis/v1/tikhub/wechat_channels/v2/fetch_video_share_url", "/apis/v1/tikhub/wechat_mp/v2/fetch_account_articles", "/apis/v1/tikhub/wechat_mp/v2/fetch_account_profile", "/apis/v1/tikhub/wechat_mp/v2/fetch_account_services", "/apis/v1/tikhub/wechat_mp/v2/fetch_article_ad", "/apis/v1/tikhub/wechat_mp/v2/fetch_article_comments", "/apis/v1/tikhub/wechat_mp/v2/fetch_article_detail", "/apis/v1/tikhub/wechat_mp/v2/fetch_article_detail_h5", "/apis/v1/tikhub/wechat_mp/v2/fetch_article_stats", "/apis/v1/tikhub/wechat_mp/v2/fetch_article_stats_h5", "/apis/v1/tikhub/wechat_mp/v2/fetch_comment_replies", "/apis/v1/tikhub/wechat_mp/v2/fetch_related_articles", "/apis/v1/tikhub/wechat_search/v2/fetch_search", "/apis/v1/tikhub/wechat_search/v2/fetch_search_videos", "/apis/v1/tikhub/weibo/app/fetch_ai_smart_search", "/apis/v1/tikhub/weibo/app/fetch_home_recommend_feed", "/apis/v1/tikhub/weibo/app/fetch_hot_search", "/apis/v1/tikhub/weibo/app/fetch_hot_search_brief", "/apis/v1/tikhub/weibo/app/fetch_hot_search_categories", "/apis/v1/tikhub/weibo/app/fetch_search_all", "/apis/v1/tikhub/weibo/app/fetch_status_comments", "/apis/v1/tikhub/weibo/app/fetch_status_detail", "/apis/v1/tikhub/weibo/app/fetch_status_likes", "/apis/v1/tikhub/weibo/app/fetch_status_reposts", "/apis/v1/tikhub/weibo/app/fetch_user_album", "/apis/v1/tikhub/weibo/app/fetch_user_articles", "/apis/v1/tikhub/weibo/app/fetch_user_audios", "/apis/v1/tikhub/weibo/app/fetch_user_followers", "/apis/v1/tikhub/weibo/app/fetch_user_following", "/apis/v1/tikhub/weibo/app/fetch_user_info", "/apis/v1/tikhub/weibo/app/fetch_user_info_detail", "/apis/v1/tikhub/weibo/app/fetch_user_profile_feed", "/apis/v1/tikhub/weibo/app/fetch_user_super_topics", "/apis/v1/tikhub/weibo/app/fetch_user_timeline", "/apis/v1/tikhub/weibo/app/fetch_user_videos", "/apis/v1/tikhub/weibo/app/fetch_video_detail", "/apis/v1/tikhub/weibo/app/fetch_video_featured_feed", "/apis/v1/tikhub/weibo/web_v2/check_allow_comment_with_pic", "/apis/v1/tikhub/weibo/web_v2/fetch_advanced_search", "/apis/v1/tikhub/weibo/web_v2/fetch_ai_related_search", "/apis/v1/tikhub/weibo/web_v2/fetch_ai_search", "/apis/v1/tikhub/weibo/web_v2/fetch_all_groups", "/apis/v1/tikhub/weibo/web_v2/fetch_city_list", "/apis/v1/tikhub/weibo/web_v2/fetch_entertainment_ranking", "/apis/v1/tikhub/weibo/web_v2/fetch_hot_ranking_timeline", "/apis/v1/tikhub/weibo/web_v2/fetch_hot_search", "/apis/v1/tikhub/weibo/web_v2/fetch_hot_search_index", "/apis/v1/tikhub/weibo/web_v2/fetch_hot_search_summary", "/apis/v1/tikhub/weibo/web_v2/fetch_life_ranking", "/apis/v1/tikhub/weibo/web_v2/fetch_pic_search", "/apis/v1/tikhub/weibo/web_v2/fetch_post_comments", "/apis/v1/tikhub/weibo/web_v2/fetch_post_detail", "/apis/v1/tikhub/weibo/web_v2/fetch_post_sub_comments", "/apis/v1/tikhub/weibo/web_v2/fetch_realtime_search", "/apis/v1/tikhub/weibo/web_v2/fetch_similar_search", "/apis/v1/tikhub/weibo/web_v2/fetch_social_ranking", "/apis/v1/tikhub/weibo/web_v2/fetch_topic_search", "/apis/v1/tikhub/weibo/web_v2/fetch_user_basic_info", "/apis/v1/tikhub/weibo/web_v2/fetch_user_fans", "/apis/v1/tikhub/weibo/web_v2/fetch_user_following", "/apis/v1/tikhub/weibo/web_v2/fetch_user_info", "/apis/v1/tikhub/weibo/web_v2/fetch_user_original_posts", "/apis/v1/tikhub/weibo/web_v2/fetch_user_posts", "/apis/v1/tikhub/weibo/web_v2/fetch_user_recommend_timeline", "/apis/v1/tikhub/weibo/web_v2/fetch_user_search", "/apis/v1/tikhub/weibo/web_v2/fetch_user_video_collection_detail", "/apis/v1/tikhub/weibo/web_v2/fetch_user_video_collection_list", "/apis/v1/tikhub/weibo/web_v2/fetch_user_video_list", "/apis/v1/tikhub/weibo/web_v2/fetch_video_search", "/apis/v1/tikhub/weibo/web_v2/search_user_posts", "/apis/v1/tikhub/xiaohongshu/app_v2/get_creator_hot_inspiration_feed", "/apis/v1/tikhub/xiaohongshu/app_v2/get_creator_inspiration_feed", "/apis/v1/tikhub/xiaohongshu/app_v2/get_image_note_detail", "/apis/v1/tikhub/xiaohongshu/app_v2/get_note_comments", "/apis/v1/tikhub/xiaohongshu/app_v2/get_note_sub_comments", "/apis/v1/tikhub/xiaohongshu/app_v2/get_product_detail", "/apis/v1/tikhub/xiaohongshu/app_v2/get_product_recommendations", "/apis/v1/tikhub/xiaohongshu/app_v2/get_product_review_overview", "/apis/v1/tikhub/xiaohongshu/app_v2/get_product_reviews", "/apis/v1/tikhub/xiaohongshu/app_v2/get_topic_feed", "/apis/v1/tikhub/xiaohongshu/app_v2/get_topic_info", "/apis/v1/tikhub/xiaohongshu/app_v2/get_user_faved_notes", "/apis/v1/tikhub/xiaohongshu/app_v2/get_user_info", "/apis/v1/tikhub/xiaohongshu/app_v2/get_user_posted_notes", "/apis/v1/tikhub/xiaohongshu/app_v2/get_video_note_detail", "/apis/v1/tikhub/xiaohongshu/app_v2/search_groups", "/apis/v1/tikhub/xiaohongshu/app_v2/search_images", "/apis/v1/tikhub/xiaohongshu/app_v2/search_notes", "/apis/v1/tikhub/xiaohongshu/app_v2/search_products", "/apis/v1/tikhub/xiaohongshu/app_v2/search_users", "/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_core_data", "/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_data_summary", "/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_detail", "/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_fans_history", "/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_fans_profile", "/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_fans_summary", "/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_filter_options", "/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_list", "/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_notes_rate", "/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_notes_v2", "/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_similar", "/apis/v1/tikhub/xiaohongshu/pgy/get_content_square", "/apis/v1/tikhub/xiaohongshu/pgy/get_keyword_daily", "/apis/v1/tikhub/xiaohongshu/pgy/get_keyword_related", "/apis/v1/tikhub/xiaohongshu/pgy/get_keyword_stat", "/apis/v1/tikhub/xiaohongshu/pgy/get_live_blogger_list", "/apis/v1/tikhub/xiaohongshu/pgy/get_note_comments", "/apis/v1/tikhub/xiaohongshu/pgy/get_note_components", "/apis/v1/tikhub/xiaohongshu/pgy/get_note_detail", "/apis/v1/tikhub/xiaohongshu/web_v3/fetch_homefeed", "/apis/v1/tikhub/xiaohongshu/web_v3/fetch_homefeed_categories", "/apis/v1/tikhub/xiaohongshu/web_v3/fetch_note_detail", "/apis/v1/tikhub/xiaohongshu/web_v3/fetch_search_suggest", "/apis/v1/tikhub/xiaohongshu/web_v3/fetch_user_info", "/apis/v1/tikhub/xigua/app/v2/fetch_one_video", "/apis/v1/tikhub/xigua/app/v2/fetch_one_video_play_url", "/apis/v1/tikhub/xigua/app/v2/fetch_user_info", "/apis/v1/tikhub/xigua/app/v2/fetch_user_post_list", "/apis/v1/tikhub/xigua/app/v2/fetch_video_comment_list", "/apis/v1/tikhub/xigua/app/v2/search_video", "/apis/v1/tikhub/youtube/web/get_channel_info", "/apis/v1/tikhub/youtube/web/get_channel_short_videos", "/apis/v1/tikhub/youtube/web/get_channel_url", "/apis/v1/tikhub/youtube/web/get_relate_video", "/apis/v1/tikhub/youtube/web/get_trending_videos", "/apis/v1/tikhub/youtube/web/search_channel", "/apis/v1/tikhub/youtube/web/search_video", "/apis/v1/tikhub/youtube/web_v2/get_channel_community_posts", "/apis/v1/tikhub/youtube/web_v2/get_channel_description", "/apis/v1/tikhub/youtube/web_v2/get_channel_id", "/apis/v1/tikhub/youtube/web_v2/get_channel_shorts", "/apis/v1/tikhub/youtube/web_v2/get_channel_url", "/apis/v1/tikhub/youtube/web_v2/get_channel_videos", "/apis/v1/tikhub/youtube/web_v2/get_general_search", "/apis/v1/tikhub/youtube/web_v2/get_post_comment_replies", "/apis/v1/tikhub/youtube/web_v2/get_post_comments", "/apis/v1/tikhub/youtube/web_v2/get_post_detail", "/apis/v1/tikhub/youtube/web_v2/get_related_videos", "/apis/v1/tikhub/youtube/web_v2/get_search_suggestions", "/apis/v1/tikhub/youtube/web_v2/get_shorts_search", "/apis/v1/tikhub/youtube/web_v2/get_signed_stream_url", "/apis/v1/tikhub/youtube/web_v2/get_video_captions", "/apis/v1/tikhub/youtube/web_v2/get_video_captions_result", "/apis/v1/tikhub/youtube/web_v2/get_video_comment_replies", "/apis/v1/tikhub/youtube/web_v2/get_video_comments", "/apis/v1/tikhub/youtube/web_v2/get_video_info", "/apis/v1/tikhub/youtube/web_v2/get_video_streams", "/apis/v1/tikhub/youtube/web_v2/search_channels", "/apis/v1/tikhub/zhihu/web/fetch_ai_search_stream", "/apis/v1/tikhub/zhihu/web/fetch_answer_detail", "/apis/v1/tikhub/zhihu/web/fetch_article_search_v3", "/apis/v1/tikhub/zhihu/web/fetch_column_article_detail", "/apis/v1/tikhub/zhihu/web/fetch_column_articles", "/apis/v1/tikhub/zhihu/web/fetch_column_comment_config", "/apis/v1/tikhub/zhihu/web/fetch_column_recommend", "/apis/v1/tikhub/zhihu/web/fetch_column_relationship", "/apis/v1/tikhub/zhihu/web/fetch_column_search_v3", "/apis/v1/tikhub/zhihu/web/fetch_comment_v5", "/apis/v1/tikhub/zhihu/web/fetch_ebook_search_v3", "/apis/v1/tikhub/zhihu/web/fetch_hot_list", "/apis/v1/tikhub/zhihu/web/fetch_hot_recommend", "/apis/v1/tikhub/zhihu/web/fetch_pin_comments", "/apis/v1/tikhub/zhihu/web/fetch_pin_detail", "/apis/v1/tikhub/zhihu/web/fetch_preset_search", "/apis/v1/tikhub/zhihu/web/fetch_question_answers", "/apis/v1/tikhub/zhihu/web/fetch_question_detail", "/apis/v1/tikhub/zhihu/web/fetch_recommend_followees", "/apis/v1/tikhub/zhihu/web/fetch_salt_search_v3", "/apis/v1/tikhub/zhihu/web/fetch_scholar_search_v3", "/apis/v1/tikhub/zhihu/web/fetch_search_recommend", "/apis/v1/tikhub/zhihu/web/fetch_search_suggest", "/apis/v1/tikhub/zhihu/web/fetch_sub_comment_v5", "/apis/v1/tikhub/zhihu/web/fetch_topic_search_v3", "/apis/v1/tikhub/zhihu/web/fetch_user_answers", "/apis/v1/tikhub/zhihu/web/fetch_user_articles", "/apis/v1/tikhub/zhihu/web/fetch_user_collections", "/apis/v1/tikhub/zhihu/web/fetch_user_follow_collections", "/apis/v1/tikhub/zhihu/web/fetch_user_follow_columns", "/apis/v1/tikhub/zhihu/web/fetch_user_follow_questions", "/apis/v1/tikhub/zhihu/web/fetch_user_follow_topics", "/apis/v1/tikhub/zhihu/web/fetch_user_followees", "/apis/v1/tikhub/zhihu/web/fetch_user_followers", "/apis/v1/tikhub/zhihu/web/fetch_user_included_articles", "/apis/v1/tikhub/zhihu/web/fetch_user_info", "/apis/v1/tikhub/zhihu/web/fetch_user_pins", "/apis/v1/tikhub/zhihu/web/fetch_user_search_v3", "/apis/v1/tikhub/zhihu/web/fetch_user_segments", "/apis/v1/tikhub/zhihu/web/fetch_video_list", "/apis/v1/tikhub/zhihu/web/fetch_video_search_v3" ], "x-aisa-document": { "facts_hash": "85ae03121f63417c9ff9d57a0fd59fdc6386fd71e2dc732a002843e6d8979d87", "generator_version": "3", "protocol_version": "1", "schema_version": "1", "composer_version": "28", "response_pending": [ { "operation_id": "post_tikhub_douyin_creator_v2_fetch_item_list_download", "path": "/apis/v1/tikhub/douyin/creator_v2/fetch_item_list_download", "method": "POST", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, { "operation_id": "get_tikhub_youtube_web_get_trending_videos", "path": "/apis/v1/tikhub/youtube/web/get_trending_videos", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" } ], "document_hash": "sha256:df487c4a3e19c6a4872d7143eb4d1bd1c40f7f1138183061ac8f6825cff9a3c2" }, "x-aisa-plans": { "builder": 1.0, "display_plan": "payg", "payg": 1.0, "similarweb_payg": 1.0, "team": 1.0, "version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb" }, "x-aisa-provider": "tikhub", "x-aisa-catalogs": { "tikhub": { "title": "TikHub (multi-platform social media data API)", "description": "", "x-aisa-document": { "facts_hash": "85ae03121f63417c9ff9d57a0fd59fdc6386fd71e2dc732a002843e6d8979d87", "generator_version": "3", "protocol_version": "1", "schema_version": "1" }, "x-aisa-plans": { "builder": 1.0, "display_plan": "payg", "payg": 1.0, "similarweb_payg": 1.0, "team": 1.0, "version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb" }, "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" } } } } }, "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema", "openapi": "3.1.0", "security": [ { "bearerAuth": [] } ], "servers": [ { "url": "https://api.aisa.one" } ], "paths": { "/apis/v1/tikhub/bilibili/app/fetch_bangumi_tab": { "get": { "description": "Bilibili (app).\n\n### Purpose:\n- Get bangumi tab (anime recommendations)\n### Return:\n- Bangumi tab data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_app_fetch_bangumi_tab", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Bangumi tab data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili fetch_bangumi_tab", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "6fbf6bc466e9" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/app/fetch_bangumi_tab", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_app_fetch_bangumi_tab", "method": "GET", "path": "/apis/v1/tikhub/bilibili/app/fetch_bangumi_tab" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:72ea38c1e251160bdea61cd235c2d0ca2319a2d1477e0983e2dd08e6aa9a73f3" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-app-fetch_bangumi_tab" } }, "/apis/v1/tikhub/bilibili/app/fetch_cinema_tab": { "get": { "description": "Bilibili (app).\n\n### Purpose:\n- Get cinema tab (movies/TV recommendations)\n### Return:\n- Cinema tab data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_app_fetch_cinema_tab", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Cinema tab data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili fetch_cinema_tab", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "cf61b95bfeac" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/app/fetch_cinema_tab", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_app_fetch_cinema_tab", "method": "GET", "path": "/apis/v1/tikhub/bilibili/app/fetch_cinema_tab" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:04f06f119adee9588b5f369a10dc30fed7be5cded44748b70af88149e19cb72f" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-app-fetch_cinema_tab" } }, "/apis/v1/tikhub/bilibili/app/fetch_home_feed": { "get": { "description": "Bilibili (app).\n\n### Purpose:\n- Get home feed (recommended videos)\n### Parameters:\n- idx: Page index, defaults to current timestamp\n- flush: Flush flag (0=normal load, 1=refresh)\n- pull: Pull to refresh\n### Return:\n- Home feed data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_app_fetch_home_feed", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Home feed data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili fetch_home_feed", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "53392fea0627" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/app/fetch_home_feed", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_app_fetch_home_feed", "method": "GET", "path": "/apis/v1/tikhub/bilibili/app/fetch_home_feed" }, "parameters": [ { "name": "flush", "in": "query", "required": false, "schema": { "type": "integer", "description": "Flush flag (0=normal load, 1=refresh)", "default": 0, "title": "Flush" }, "description": "Flush flag (0=normal load, 1=refresh)" }, { "name": "idx", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page index, defaults to current timestamp", "title": "Idx" }, "description": "Page index, defaults to current timestamp" }, { "name": "pull", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Pull to refresh", "default": true, "title": "Pull" }, "description": "Pull to refresh" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:0ad7c20b2f4ae67986a9fdd6d1257005b51662473f89c92cde9de9aa2a7e0358" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-app-fetch_home_feed" } }, "/apis/v1/tikhub/bilibili/app/fetch_one_video": { "get": { "description": "Bilibili (app).\n\n### Purpose:\n- Get single video data (APP API)\n### Parameters:\n- av_id: AV ID (choose one of av_id or bv_id)\n- bv_id: BV ID (choose one of av_id or bv_id)\n### Return:\n- Video data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_app_fetch_one_video", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Video data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili fetch_one_video", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "4106b79912cc" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/app/fetch_one_video", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_app_fetch_one_video", "method": "GET", "path": "/apis/v1/tikhub/bilibili/app/fetch_one_video" }, "parameters": [ { "name": "av_id", "in": "query", "required": false, "schema": { "type": "string", "description": "AV ID (choose one of av_id or bv_id)", "title": "Av Id" }, "description": "AV ID (choose one of av_id or bv_id)", "example": "115568241811221" }, { "name": "bv_id", "in": "query", "required": false, "schema": { "type": "string", "description": "BV ID (choose one of av_id or bv_id)", "title": "Bv Id" }, "description": "BV ID (choose one of av_id or bv_id)", "example": "BV18SCrBGE9E" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:77955fe0d15635857c070a6aa28493a874baf14b10f13e971e4bab6f9bc7a032" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-app-fetch_one_video" } }, "/apis/v1/tikhub/bilibili/app/fetch_popular_feed": { "get": { "description": "Bilibili (app).\n\n### Purpose:\n- Get popular feed\n### Parameters:\n- idx: Page index (starting from 1)\n- last_param: Last video ID from previous page (for pagination)\n### Return:\n- Popular feed data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_app_fetch_popular_feed", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Popular feed data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili fetch_popular_feed", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "11aa622e4d85" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/app/fetch_popular_feed", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_app_fetch_popular_feed", "method": "GET", "path": "/apis/v1/tikhub/bilibili/app/fetch_popular_feed" }, "parameters": [ { "name": "idx", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page index (starting from 1)", "default": 1, "title": "Idx" }, "description": "Page index (starting from 1)" }, { "name": "last_param", "in": "query", "required": false, "schema": { "type": "string", "description": "Last video ID from previous page (for pagination)", "title": "Last Param" }, "description": "Last video ID from previous page (for pagination)" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:6b737d2498f89716559b95b01bd78543436b642511c2f60de7b6b4c3aa7a7980" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-app-fetch_popular_feed" } }, "/apis/v1/tikhub/bilibili/app/fetch_reply_detail": { "get": { "description": "Bilibili (app).\n\n### Purpose:\n- Get reply detail (second level comments)\n### Parameters:\n- root: Root comment ID (required)\n- av_id: AV ID (choose one of av_id or bv_id)\n- bv_id: BV ID (choose one of av_id or bv_id)\n- next_offset: Next page cursor\n- ps: Page size\n### Return:\n- Reply data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_app_fetch_reply_detail", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Reply data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili fetch_reply_detail", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "cbb88b5a1100" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/app/fetch_reply_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_app_fetch_reply_detail", "method": "GET", "path": "/apis/v1/tikhub/bilibili/app/fetch_reply_detail" }, "parameters": [ { "name": "av_id", "in": "query", "required": false, "schema": { "type": "string", "description": "AV ID (choose one of av_id or bv_id)", "title": "Av Id" }, "description": "AV ID (choose one of av_id or bv_id)", "example": "113100682434775" }, { "name": "bv_id", "in": "query", "required": false, "schema": { "type": "string", "description": "BV ID (choose one of av_id or bv_id)", "title": "Bv Id" }, "description": "BV ID (choose one of av_id or bv_id)", "example": "BV18SCrBGE9E" }, { "name": "next_offset", "in": "query", "required": false, "schema": { "type": "integer", "description": "Next page cursor", "default": 0, "title": "Next Offset" }, "description": "Next page cursor" }, { "name": "ps", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page size", "default": 20, "title": "Ps" }, "description": "Page size" }, { "name": "root", "in": "query", "required": true, "schema": { "type": "string", "description": "Root comment ID", "title": "Root" }, "description": "Root comment ID", "example": "241743663521" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:254bb1a7c6e224272793607eef859d21a179b6dc56e8159b20cd6a25c4885dfe" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/bilibili/app/fetch_reply_detail?av_id=113100682434775&bv_id=BV18SCrBGE9E&root=241743663521' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-app-fetch_reply_detail" } }, "/apis/v1/tikhub/bilibili/app/fetch_search_all": { "get": { "description": "Bilibili (app).\n\n### Purpose:\n- search all (returns all types of search results)\n### Parameters:\n- keyword: Search keyword (required)\n- cursor: Pagination cursor. Leave empty for the first page; for the next page pass\n back `data.pagination.next` from the previous response. This endpoint uses cursor\n pagination and does not support random access by page number.\n- page_size: Results per page\n- order: Sort order (0=comprehensive)\n### Return:\n- Search results including nav (category navigation), item (results), pagination, etc.\n- Next-page cursor: `$.data.data.pagination.next`; pass it back as `cursor` on the next\n request. When this field is absent (pagination is omitted on the last page) or empty,\n there is no more data and you should stop paginating.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_app_fetch_search_all", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Search results including nav (category navigation), item (results), pagination, etc.\n- Next-page cursor: `$.data.data.pagination.next`; pass it back as `cursor` on the next\n request. When this field is absent (pagination is omitted on the last page) or empty,\n there is no more data and you should stop paginating.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili fetch_search_all", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "9114a18f203d" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/app/fetch_search_all", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_app_fetch_search_all", "method": "GET", "path": "/apis/v1/tikhub/bilibili/app/fetch_search_all" }, "parameters": [ { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination cursor. Leave empty for the first page; for the next page pass\n back `data.pagination.next` from the previous response. This endpoint uses cursor\n pagination and does not support random access by page number.", "default": "", "title": "Cursor" }, "description": "Pagination cursor. Leave empty for the first page; for the next page pass\n back `data.pagination.next` from the previous response. This endpoint uses cursor\n pagination and does not support random access by page number." }, { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Search keyword", "title": "Keyword" }, "description": "Search keyword", "example": "Genshin Impact" }, { "name": "order", "in": "query", "required": false, "schema": { "type": "integer", "description": "Sort order: 0=Comprehensive", "default": 0, "title": "Order" }, "description": "Sort order: 0=Comprehensive" }, { "name": "page_size", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page size", "default": 20, "title": "Page Size" }, "description": "Page size" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:dcd9b1c9ee4ff9cb991a3942253a6988273d8a1567330263e8cd2580f1aac8ae" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/bilibili/app/fetch_search_all?keyword=Genshin+Impact' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-app-fetch_search_all" } }, "/apis/v1/tikhub/bilibili/app/fetch_search_by_type": { "get": { "description": "Bilibili (app).\n\n### Purpose:\n- search by type\n### Parameters:\n- keyword: Search keyword (required)\n- search_type: Search type\n - video: Videos\n - bangumi: Anime\n - pgc: Movies/TV\n - live: Live streams\n - article: Articles\n - user: Users\n- cursor: Pagination cursor. Leave empty for the first page; for the next page pass\n back `data.pagination.next` from the previous response. This endpoint uses cursor\n pagination and does not support random access by page number.\n- page_size: Results per page\n- order: Sort order\n - 0: Comprehensive\n - 1: Latest\n - 2: Play count\n - 3: Danmaku count\n### Return:\n- Search results\n- Next-page cursor: `$.data.data.pagination.next`; pass it back as `cursor` on the next\n request. When this field is absent (pagination is omitted on the last page) or empty,\n there is no more data and you should stop paginating.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_app_fetch_search_by_type", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Search results\n- Next-page cursor: `$.data.data.pagination.next`; pass it back as `cursor` on the next\n request. When this field is absent (pagination is omitted on the last page) or empty,\n there is no more data and you should stop paginating.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili fetch_search_by_type", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "d603d2a2c364" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/app/fetch_search_by_type", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_app_fetch_search_by_type", "method": "GET", "path": "/apis/v1/tikhub/bilibili/app/fetch_search_by_type" }, "parameters": [ { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination cursor. Leave empty for the first page; for the next page pass\n back `data.pagination.next` from the previous response. This endpoint uses cursor\n pagination and does not support random access by page number.", "default": "", "title": "Cursor" }, "description": "Pagination cursor. Leave empty for the first page; for the next page pass\n back `data.pagination.next` from the previous response. This endpoint uses cursor\n pagination and does not support random access by page number." }, { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Search keyword", "title": "Keyword" }, "description": "Search keyword", "example": "Genshin Impact" }, { "name": "order", "in": "query", "required": false, "schema": { "type": "integer", "description": "Sort order: 0=Comprehensive, 1=Latest, 2=Views, 3=Bullet comment count\n\nUsage: Sort order\n - 0: Comprehensive\n - 1: Latest\n - 2: Play count\n - 3: Danmaku count", "default": 0, "title": "Order" }, "description": "Sort order: 0=Comprehensive, 1=Latest, 2=Views, 3=Bullet comment count\n\nUsage: Sort order\n - 0: Comprehensive\n - 1: Latest\n - 2: Play count\n - 3: Danmaku count" }, { "name": "page_size", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page size", "default": 20, "title": "Page Size" }, "description": "Page size" }, { "name": "search_type", "in": "query", "required": false, "schema": { "type": "string", "description": "Search type\n - video: Videos\n - bangumi: Anime\n - pgc: Movies/TV\n - live: Live streams\n - article: Articles\n - user: Users", "default": "video", "title": "Search Type" }, "description": "Search type\n - video: Videos\n - bangumi: Anime\n - pgc: Movies/TV\n - live: Live streams\n - article: Articles\n - user: Users" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:02a9a95ee7d4573799b46be8a055f14b60775c0f68e24f923291c2481b5a8c5f" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/bilibili/app/fetch_search_by_type?keyword=Genshin+Impact' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-app-fetch_search_by_type" } }, "/apis/v1/tikhub/bilibili/app/fetch_user_info": { "get": { "description": "Bilibili (app).\n\n### Purpose:\n- Get user info\n### Parameters:\n- user_id: User ID (required)\n### Return:\n- User info (including followers, following, videos count, etc.)\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_app_fetch_user_info", "responses": { "200": { "description": "Successful Response\n\n### Return\n- User info (including followers, following, videos count, etc.)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili fetch_user_info", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "e42707eff7da" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/app/fetch_user_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_app_fetch_user_info", "method": "GET", "path": "/apis/v1/tikhub/bilibili/app/fetch_user_info" }, "parameters": [ { "name": "user_id", "in": "query", "required": true, "schema": { "type": "string", "description": "User ID", "title": "User Id" }, "description": "User ID", "example": "203680252" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:c31dc879499e1690341b78d8a69b365a1dd1d1cb2b6559b743af31802805814a" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/bilibili/app/fetch_user_info?user_id=203680252' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-app-fetch_user_info" } }, "/apis/v1/tikhub/bilibili/app/fetch_user_videos": { "get": { "description": "Bilibili (app).\n\n### Purpose:\n- Get user uploaded videos\n### Parameters:\n- user_id: User ID (required)\n- post_filter: Filter type (archive/season/contribute)\n- page: Page number\n- ps: Page size\n### Return:\n- User videos data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_app_fetch_user_videos", "responses": { "200": { "description": "Successful Response\n\n### Return\n- User videos data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili fetch_user_videos", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a0a0efac3f3e" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/app/fetch_user_videos", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_app_fetch_user_videos", "method": "GET", "path": "/apis/v1/tikhub/bilibili/app/fetch_user_videos" }, "parameters": [ { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page number", "default": 1, "title": "Page" }, "description": "Page number" }, { "name": "post_filter", "in": "query", "required": false, "schema": { "type": "string", "description": "Filter type (archive/season/contribute)", "default": "archive", "title": "Post Filter" }, "description": "Filter type (archive/season/contribute)" }, { "name": "ps", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page size", "default": 20, "title": "Ps" }, "description": "Page size" }, { "name": "user_id", "in": "query", "required": true, "schema": { "type": "string", "description": "User ID", "title": "User Id" }, "description": "User ID", "example": "203680252" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:eb294d06fe866d68fd800686ae9a94d2319a0daf7994070fb1c5fe1e7178569e" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/bilibili/app/fetch_user_videos?user_id=203680252' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-app-fetch_user_videos" } }, "/apis/v1/tikhub/bilibili/app/fetch_video_comments": { "get": { "description": "Bilibili (app).\n\n### Purpose:\n- Get video comments\n### Parameters:\n- av_id: AV ID (choose one of av_id or bv_id)\n- bv_id: BV ID (choose one of av_id or bv_id)\n- mode: Sort mode (3=hot, 2=time)\n- next_offset: Pagination cursor\n### Return:\n- Comments data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_app_fetch_video_comments", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Comments data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili fetch_video_comments", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "f6d0b6593de0" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/app/fetch_video_comments", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_app_fetch_video_comments", "method": "GET", "path": "/apis/v1/tikhub/bilibili/app/fetch_video_comments" }, "parameters": [ { "name": "av_id", "in": "query", "required": false, "schema": { "type": "string", "description": "AV ID (choose one of av_id or bv_id)", "title": "Av Id" }, "description": "AV ID (choose one of av_id or bv_id)", "example": "115568241811221" }, { "name": "bv_id", "in": "query", "required": false, "schema": { "type": "string", "description": "BV ID (choose one of av_id or bv_id)", "title": "Bv Id" }, "description": "BV ID (choose one of av_id or bv_id)", "example": "BV18SCrBGE9E" }, { "name": "mode", "in": "query", "required": false, "schema": { "type": "integer", "description": "Sort mode: 3=hot, 2=time", "default": 3, "title": "Mode" }, "description": "Sort mode: 3=hot, 2=time" }, { "name": "next_offset", "in": "query", "required": false, "schema": { "type": "integer", "description": "Pagination cursor", "default": 1, "title": "Next Offset" }, "description": "Pagination cursor" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:ba0b022bed3baa2ae848869b2620b5a0dc659cd8b700d13c7fe3969d42c9ca27" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-app-fetch_video_comments" } }, "/apis/v1/tikhub/bilibili/huahuo/account_session_info": { "get": { "description": "Bilibili (huahuo). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Retrieve the current advertiser's identity and role information to\n identify the business account associated with the returned data.\n\n### Parameters\n- None.\n\n### Returns\n- Advertiser ID, user ID, username, operator type, UID name, MID, and\n related account fields.\n\n### Billing\n\n\nPublished reference price: $0.006 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_huahuo_account_session_info", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Advertiser ID, user ID, username, operator type, UID name, MID, and\n related account fields.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili account_session_info", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.006, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "532eada801a9" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/huahuo/account_session_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_huahuo_account_session_info", "method": "GET", "path": "/apis/v1/tikhub/bilibili/huahuo/account_session_info" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:950292da3ca5c9659e24f1c88543531ffccde75d1b7c86c20caa09ea5078f601" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-huahuo-account_session_info" } }, "/apis/v1/tikhub/bilibili/huahuo/cooperate_experience_industry": { "get": { "description": "Bilibili (huahuo). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Retrieve detailed industries used by collaboration-experience filters on\n non-general strategy panels. For the general panel (`panel_type=0`), use\n `square_static_info.data.industry_tree` instead.\n\n### Parameters\n- `industry_type`: Required business industry: `1` gaming, `2` personal\n care/small appliances, `3` digital appliances, `4` automotive,\n `5` food and beverage, or `6` internet services.\n\n### Returns\n- Put selected IDs in `search_upper.cooperate_experience_industry_ids`.\n- Also set `search_upper.cooperate_experience_type`: without selected\n industries, use `3`=no experience in the current industry, `1`=some current-\n industry experience, `2`=extensive current-industry experience, or `4`=other-\n industry experience. With selected industries, use only `1` or `2`.\n\n### Example\n`GET /tikhub/bilibili/huahuo/cooperate_experience_industry?industry_type=1`\n\n### Billing\n\nAPI references: `search_upper` = `POST /tikhub/bilibili/huahuo/search_upper` (operationId: `post_tikhub_bilibili_huahuo_search_upper`); `square_static_info` = `GET /tikhub/bilibili/huahuo/square_static_info` (operationId: `get_tikhub_bilibili_huahuo_square_static_info`).\n\n\nPublished reference price: $0.006 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_huahuo_cooperate_experience_industry", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Put selected IDs in `search_upper.cooperate_experience_industry_ids`.\n- Also set `search_upper.cooperate_experience_type`: without selected\n industries, use `3`=no experience in the current industry, `1`=some current-\n industry experience, `2`=extensive current-industry experience, or `4`=other-\n industry experience. With selected industries, use only `1` or `2`.\n\nAPI references: `search_upper` = `POST /tikhub/bilibili/huahuo/search_upper` (operationId: `post_tikhub_bilibili_huahuo_search_upper`).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili cooperate_experience_industry", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.006, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a0509f54f266" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/huahuo/cooperate_experience_industry", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_huahuo_cooperate_experience_industry", "method": "GET", "path": "/apis/v1/tikhub/bilibili/huahuo/cooperate_experience_industry" }, "parameters": [ { "name": "industry_type", "in": "query", "required": true, "schema": { "type": "integer", "description": "Industry index: 1=Gaming, 2=Daily Chemicals/Small Appliances, 3=Consumer Electronics, 4=Automotive, 5=Food & Beverage, 6=Online Services\n\nUsage: Required business industry: `1` gaming, `2` personal\n care/small appliances, `3` digital appliances, `4` automotive,\n `5` food and beverage, or `6` internet services.", "title": "Industry Type" }, "description": "Industry index: 1=Gaming, 2=Daily Chemicals/Small Appliances, 3=Consumer Electronics, 4=Automotive, 5=Food & Beverage, 6=Online Services\n\nUsage: Required business industry: `1` gaming, `2` personal\n care/small appliances, `3` digital appliances, `4` automotive,\n `5` food and beverage, or `6` internet services." } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:825a8cc4d1fd63f0d95ca12278bf345e96695d30cc42afded243e71c196e88ba" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-huahuo-cooperate_experience_industry" } }, "/apis/v1/tikhub/bilibili/huahuo/dmp_pkg_list": { "get": { "description": "Bilibili (huahuo). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Retrieve custom audience packages available to the current advertiser\n for audience-matching filters.\n\n### Parameters\n- None.\n\n### Returns\n- Audience package IDs, names, labels, and available matching metrics. Put the\n selected custom package ID in `search_upper.dmp_group_id`.\n\n### Example\n`GET /tikhub/bilibili/huahuo/dmp_pkg_list`\n\n### Billing\n\nAPI references: `search_upper` = `POST /tikhub/bilibili/huahuo/search_upper` (operationId: `post_tikhub_bilibili_huahuo_search_upper`).\n\n\nPublished reference price: $0.006 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_huahuo_dmp_pkg_list", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- Audience package IDs, names, labels, and available matching metrics. Put the\n selected custom package ID in `search_upper.dmp_group_id`.\n\nAPI references: `search_upper` = `POST /tikhub/bilibili/huahuo/search_upper` (operationId: `post_tikhub_bilibili_huahuo_search_upper`).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili dmp_pkg_list", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.006, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "77ad56428126" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/huahuo/dmp_pkg_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_huahuo_dmp_pkg_list", "method": "GET", "path": "/apis/v1/tikhub/bilibili/huahuo/dmp_pkg_list" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:04718178a9734bd287537aa1101d4d0040f8e1a3c984d98bbe982fd57d9aef9d" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-huahuo-dmp_pkg_list" } }, "/apis/v1/tikhub/bilibili/huahuo/effect_goods_drop": { "get": { "description": "Bilibili (huahuo). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Retrieve product categories supported by content-commerce filters.\n\n### Parameters\n- None.\n\n### Returns\n- Product category IDs, names, and hierarchy. Put selected first- and second-\n level IDs in `search_upper.goods_category_first_ids` and\n `goods_category_second_ids`.\n\n### Example\n`GET /tikhub/bilibili/huahuo/effect_goods_drop`\n\n### Billing\n\nAPI references: `search_upper` = `POST /tikhub/bilibili/huahuo/search_upper` (operationId: `post_tikhub_bilibili_huahuo_search_upper`).\n\n\nPublished reference price: $0.006 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_huahuo_effect_goods_drop", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Product category IDs, names, and hierarchy. Put selected first- and second-\n level IDs in `search_upper.goods_category_first_ids` and\n `goods_category_second_ids`.\n\nAPI references: `search_upper` = `POST /tikhub/bilibili/huahuo/search_upper` (operationId: `post_tikhub_bilibili_huahuo_search_upper`).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili effect_goods_drop", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.006, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "cdb6350ac512" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/huahuo/effect_goods_drop", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_huahuo_effect_goods_drop", "method": "GET", "path": "/apis/v1/tikhub/bilibili/huahuo/effect_goods_drop" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:3486c4b22e7e22b9ae028f5a86fd52783a2374bc1ce6e973cf8f929e29addeca" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-huahuo-effect_goods_drop" } }, "/apis/v1/tikhub/bilibili/huahuo/industry_tags": { "get": { "description": "Bilibili (huahuo). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Retrieve industry tags used in advertiser and content collaboration scenarios.\n\n### Parameters\n- None.\n\n### Returns\n- Industry tag IDs, names, and category information.\n\n### Billing\n\n\nPublished reference price: $0.006 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_huahuo_industry_tags", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Industry tag IDs, names, and category information.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili industry_tags", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.006, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "01e9520ade29" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/huahuo/industry_tags", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_huahuo_industry_tags", "method": "GET", "path": "/apis/v1/tikhub/bilibili/huahuo/industry_tags" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:6249ea4b430457dc3cd4099202a5f165dd642739dd7f270c1af62651206f499a" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-huahuo-industry_tags" } }, "/apis/v1/tikhub/bilibili/huahuo/label_char_style": { "get": { "description": "Bilibili (huahuo). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Retrieve tags describing creators' content presentation and visual style.\n\n### Parameters\n- None.\n\n### Returns\n- Content-style tag IDs, names, and display information.\n\n### Billing\n\n\nPublished reference price: $0.006 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_huahuo_label_char_style", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Content-style tag IDs, names, and display information.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili label_char_style", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.006, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "18997a4ccd61" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/huahuo/label_char_style", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_huahuo_label_char_style", "method": "GET", "path": "/apis/v1/tikhub/bilibili/huahuo/label_char_style" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:6d3cfe6653766825d0ef761ea0ab8b46337344e9cb03e2483c0f1c643cb45d37" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-huahuo-label_char_style" } }, "/apis/v1/tikhub/bilibili/huahuo/live_area_list": { "get": { "description": "Bilibili (huahuo). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Retrieve live content categories used by live creator marketplace filters.\n\n### Parameters\n- None.\n\n### Returns\n- First- and second-level live category IDs, names, and hierarchy.\n\n### Billing\n\n\nPublished reference price: $0.006 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_huahuo_live_area_list", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- First- and second-level live category IDs, names, and hierarchy.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili live_area_list", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.006, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "1aa01c57ff9e" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/huahuo/live_area_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_huahuo_live_area_list", "method": "GET", "path": "/apis/v1/tikhub/bilibili/huahuo/live_area_list" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:39967397c2d495e26e388f511febc4922b8594d398502cce72e118321b1d12d6" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-huahuo-live_area_list" } }, "/apis/v1/tikhub/bilibili/huahuo/live_commerce_info": { "get": { "description": "Bilibili (huahuo). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Query a creator's live-commerce capabilities and recent commercial performance.\n\n### Parameters\n- `upper_mid`: Required creator UID.\n\n### Returns\n- Live-commerce sessions, product categories, transaction performance,\n audience, engagement, and related commercial metrics.\n\n### Billing\n\n\nPublished reference price: $0.006 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_huahuo_live_commerce_info", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- Live-commerce sessions, product categories, transaction performance,\n audience, engagement, and related commercial metrics.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili live_commerce_info", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.006, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "3e81211ec1f4" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/huahuo/live_commerce_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_huahuo_live_commerce_info", "method": "GET", "path": "/apis/v1/tikhub/bilibili/huahuo/live_commerce_info" }, "parameters": [ { "name": "upper_mid", "in": "query", "required": true, "schema": { "type": "integer", "description": "Creator UID", "title": "Upper Mid" }, "description": "Creator UID" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:cd44e8dc0a9a719ca6ab2f754e03f1d4f15bdaf6d2e992442491546254df3e45" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-huahuo-live_commerce_info" } }, "/apis/v1/tikhub/bilibili/huahuo/live_good_category": { "get": { "description": "Bilibili (huahuo). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Retrieve primary live-commerce product categories for filtering creators\n with relevant category experience.\n\n### Parameters\n- None.\n\n### Returns\n- Live-commerce category IDs, names, and display order.\n\n### Billing\n\n\nPublished reference price: $0.006 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_huahuo_live_good_category", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Live-commerce category IDs, names, and display order.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili live_good_category", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.006, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "276cd2ab02e2" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/huahuo/live_good_category", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_huahuo_live_good_category", "method": "GET", "path": "/apis/v1/tikhub/bilibili/huahuo/live_good_category" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:199b6e9a503f23f3f404a959d0fa96e8997ecbb8482597eb4d947ed5a441f04a" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-huahuo-live_good_category" } }, "/apis/v1/tikhub/bilibili/huahuo/live_guild_drop": { "get": { "description": "Bilibili (huahuo). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Retrieve live-streaming guilds available as marketplace filters.\n\n### Parameters\n- `name`: Optional partial guild name. An empty string returns all available results.\n\n### Returns\n- Live guild IDs, names, and display information.\n\n### Billing\n\n\nPublished reference price: $0.006 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_huahuo_live_guild_drop", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Live guild IDs, names, and display information.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili live_guild_drop", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.006, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "697ce437e158" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/huahuo/live_guild_drop", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_huahuo_live_guild_drop", "method": "GET", "path": "/apis/v1/tikhub/bilibili/huahuo/live_guild_drop" }, "parameters": [ { "name": "name", "in": "query", "required": false, "schema": { "type": "string", "description": "Fuzzy filter by name; empty=all\n\nUsage: Optional partial guild name. An empty string returns all available results.", "default": "", "title": "Name" }, "description": "Fuzzy filter by name; empty=all\n\nUsage: Optional partial guild name. An empty string returns all available results." } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e2f8dee89f10be691a5c5f9ad8990f2fdf1fbf6676e1328cc09460ace007d021" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-huahuo-live_guild_drop" } }, "/apis/v1/tikhub/bilibili/huahuo/live_parent_tag": { "get": { "description": "Bilibili (huahuo). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Retrieve persona labels describing live creators' style and content positioning.\n\n### Parameters\n- None.\n\n### Returns\n- Live creator persona tag IDs, names, and display information.\n\n### Billing\n\n\nPublished reference price: $0.006 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_huahuo_live_parent_tag", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Live creator persona tag IDs, names, and display information.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili live_parent_tag", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.006, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "eb2e7b7da711" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/huahuo/live_parent_tag", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_huahuo_live_parent_tag", "method": "GET", "path": "/apis/v1/tikhub/bilibili/huahuo/live_parent_tag" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:522d8a693fdcd14c20f4356725c1657f876791e46bc13e243b53f87405fc0a9c" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-huahuo-live_parent_tag" } }, "/apis/v1/tikhub/bilibili/huahuo/live_upper_portrait": { "get": { "description": "Bilibili (huahuo). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Retrieve a creator's live-streaming profile for evaluating branded-live\n collaboration capabilities.\n\n### Parameters\n- `mcn_id`: Required MCN organization ID, available from marketplace\n results or `upper_base_info`.\n- `upper_mid`: Optional creator UID used to narrow the target creator.\n\n### Returns\n- Creator profile, live performance, audience size, engagement metrics,\n live tags, and collaboration-capability information.\n\n### Billing\n\nAPI references: `upper_base_info` = `GET /tikhub/bilibili/huahuo/upper_base_info` (operationId: `get_tikhub_bilibili_huahuo_upper_base_info`).\n\n\nPublished reference price: $0.006 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_huahuo_live_upper_portrait", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- Creator profile, live performance, audience size, engagement metrics,\n live tags, and collaboration-capability information.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili live_upper_portrait", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.006, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "87ac5a5b8004" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/huahuo/live_upper_portrait", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_huahuo_live_upper_portrait", "method": "GET", "path": "/apis/v1/tikhub/bilibili/huahuo/live_upper_portrait" }, "parameters": [ { "name": "mcn_id", "in": "query", "required": true, "schema": { "type": "integer", "description": "MCN organization ID, obtainable from marketplace search results or upper_base_info\n\nUsage: Required MCN organization ID, available from marketplace\n results or `upper_base_info`.\n\nAPI references: `upper_base_info` = `GET /tikhub/bilibili/huahuo/upper_base_info` (operationId: `get_tikhub_bilibili_huahuo_upper_base_info`).", "title": "Mcn Id" }, "description": "MCN organization ID, obtainable from marketplace search results or upper_base_info\n\nUsage: Required MCN organization ID, available from marketplace\n results or `upper_base_info`.\n\nAPI references: `upper_base_info` = `GET /tikhub/bilibili/huahuo/upper_base_info` (operationId: `get_tikhub_bilibili_huahuo_upper_base_info`)." }, { "name": "upper_mid", "in": "query", "required": false, "schema": { "description": "Optional creator UID used to narrow the target creator.", "title": "Upper Mid", "type": [ "integer", "null" ] }, "description": "Optional creator UID used to narrow the target creator." } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:d914f24c07403440a90ef0ef910dd3f2c866a08aeb10dda35c9863ff092e511e" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-huahuo-live_upper_portrait" } }, "/apis/v1/tikhub/bilibili/huahuo/mcn_drop": { "get": { "description": "Bilibili (huahuo). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Retrieve MCN organizations available for creator search filters.\n\n### Parameters\n- `name`: Optional partial MCN name. An empty string returns all available results.\n\n### Returns\n- MCN organization IDs, names, and display information. Put selected IDs in\n the `search_upper.mcn_ids` array.\n\n### Example\n`GET /tikhub/bilibili/huahuo/mcn_drop?name=`\n\n### Billing\n\nAPI references: `search_upper` = `POST /tikhub/bilibili/huahuo/search_upper` (operationId: `post_tikhub_bilibili_huahuo_search_upper`).\n\n\nPublished reference price: $0.006 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_huahuo_mcn_drop", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- MCN organization IDs, names, and display information. Put selected IDs in\n the `search_upper.mcn_ids` array.\n\nAPI references: `search_upper` = `POST /tikhub/bilibili/huahuo/search_upper` (operationId: `post_tikhub_bilibili_huahuo_search_upper`).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili mcn_drop", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.006, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "258fcdfaaf5c" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/huahuo/mcn_drop", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_huahuo_mcn_drop", "method": "GET", "path": "/apis/v1/tikhub/bilibili/huahuo/mcn_drop" }, "parameters": [ { "name": "name", "in": "query", "required": false, "schema": { "type": "string", "description": "Fuzzy filter by name; empty=all\n\nUsage: Optional partial MCN name. An empty string returns all available results.", "default": "", "title": "Name" }, "description": "Fuzzy filter by name; empty=all\n\nUsage: Optional partial MCN name. An empty string returns all available results." } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:950855719f43536f38525c6b3a5c1a9a591fbef34ddcafc3b532b9c5db40c1b3" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-huahuo-mcn_drop" } }, "/apis/v1/tikhub/bilibili/huahuo/partition_drop": { "get": { "description": "Bilibili (huahuo). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Retrieve video content categories used to filter creators or content by topic.\n\n### Parameters\n- None.\n\n### Returns\n- First- and second-level video category IDs, names, and hierarchy. Put the\n selected first-level ID in `search_upper.partition_id` and second-level IDs\n in `search_upper.second_partition_id`.\n\n### Example\n`GET /tikhub/bilibili/huahuo/partition_drop`\n\n### Billing\n\nAPI references: `search_upper` = `POST /tikhub/bilibili/huahuo/search_upper` (operationId: `post_tikhub_bilibili_huahuo_search_upper`).\n\n\nPublished reference price: $0.006 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_huahuo_partition_drop", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- First- and second-level video category IDs, names, and hierarchy. Put the\n selected first-level ID in `search_upper.partition_id` and second-level IDs\n in `search_upper.second_partition_id`.\n\nAPI references: `search_upper` = `POST /tikhub/bilibili/huahuo/search_upper` (operationId: `post_tikhub_bilibili_huahuo_search_upper`).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili partition_drop", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.006, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "c5757d6128fc" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/huahuo/partition_drop", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_huahuo_partition_drop", "method": "GET", "path": "/apis/v1/tikhub/bilibili/huahuo/partition_drop" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:083833289638fd305f2a05016a274f9c3ea180529cb2d185d668f141cbfb9ef9" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-huahuo-partition_drop" } }, "/apis/v1/tikhub/bilibili/huahuo/popular_avid_category_drop": { "get": { "description": "Bilibili (huahuo). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get industry names supported by the Huahuo video ranking endpoint.\n\n### Parameters\n- None.\n\n### Returns\n- Available video-ranking industry names and display information.\n\n### Billing\n\n\nPublished reference price: $0.006 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_huahuo_popular_avid_category_drop", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Available video-ranking industry names and display information.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili popular_avid_category_drop", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.006, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "f0ee0342e985" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/huahuo/popular_avid_category_drop", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_huahuo_popular_avid_category_drop", "method": "GET", "path": "/apis/v1/tikhub/bilibili/huahuo/popular_avid_category_drop" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:ee6c9d0e32273073d3620306b421ad4a9dd4a3d4a38c6c7ffd7c6a11ee71afbb" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-huahuo-popular_avid_category_drop" } }, "/apis/v1/tikhub/bilibili/huahuo/popular_avid_list": { "get": { "description": "Bilibili (huahuo). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Retrieve Huahuo video rankings for a selected industry or all industries.\n\n### Parameters\n- `category`: Industry name from `popular_avid_category_drop`; an empty\n string means all industries.\n- `page`: One-based page number.\n\n### Returns\n- Video ranks, identifiers, titles, covers, creator profiles, playback and\n engagement metrics, and pagination information.\n\n### Billing\n\nAPI references: `popular_avid_category_drop` = `GET /tikhub/bilibili/huahuo/popular_avid_category_drop` (operationId: `get_tikhub_bilibili_huahuo_popular_avid_category_drop`).\n\n\nPublished reference price: $0.006 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_huahuo_popular_avid_list", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Video ranks, identifiers, titles, covers, creator profiles, playback and\n engagement metrics, and pagination information.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili popular_avid_list", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.006, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "81b32151dd05" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/huahuo/popular_avid_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_huahuo_popular_avid_list", "method": "GET", "path": "/apis/v1/tikhub/bilibili/huahuo/popular_avid_list" }, "parameters": [ { "name": "category", "in": "query", "required": false, "schema": { "type": "string", "description": "Industry name; valid values from popular_avid_category_drop, empty=all\n\nUsage: Industry name from `popular_avid_category_drop`; an empty\n string means all industries.\n\nAPI references: `popular_avid_category_drop` = `GET /tikhub/bilibili/huahuo/popular_avid_category_drop` (operationId: `get_tikhub_bilibili_huahuo_popular_avid_category_drop`).", "default": "", "title": "Category" }, "description": "Industry name; valid values from popular_avid_category_drop, empty=all\n\nUsage: Industry name from `popular_avid_category_drop`; an empty\n string means all industries.\n\nAPI references: `popular_avid_category_drop` = `GET /tikhub/bilibili/huahuo/popular_avid_category_drop` (operationId: `get_tikhub_bilibili_huahuo_popular_avid_category_drop`)." }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "default": 1, "title": "Page" }, "description": "One-based page number." } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e646c1cfb9c663480332125379ec8574c9f81159587d5b6e4177dd116880de48" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-huahuo-popular_avid_list" } }, "/apis/v1/tikhub/bilibili/huahuo/popular_goods_industry_up_list": { "get": { "description": "Bilibili (huahuo). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Find creators with strong commerce performance in a selected product industry.\n\n### Parameters\n- `x_huo_industry_id`: Required product-ranking industry ID from\n `x_huo_industry_drop?scene=2`.\n- `page`: One-based page number.\n\n### Returns\n- Industry commerce creator ranks, profiles, performance metrics, and pagination information.\n\n### Billing\n\nAPI references: `x_huo_industry_drop` = `GET /tikhub/bilibili/huahuo/x_huo_industry_drop` (operationId: `get_tikhub_bilibili_huahuo_x_huo_industry_drop`).\n\n\nPublished reference price: $0.006 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_huahuo_popular_goods_industry_up_list", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Industry commerce creator ranks, profiles, performance metrics, and pagination information.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili popular_goods_industry_up_list", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.006, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "0770935943e1" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/huahuo/popular_goods_industry_up_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_huahuo_popular_goods_industry_up_list", "method": "GET", "path": "/apis/v1/tikhub/bilibili/huahuo/popular_goods_industry_up_list" }, "parameters": [ { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "default": 1, "title": "Page" }, "description": "One-based page number." }, { "name": "x_huo_industry_id", "in": "query", "required": true, "schema": { "type": "integer", "description": "Industry ID; valid values from x_huo_industry_drop?scene=2\n\nUsage: Required product-ranking industry ID from\n `x_huo_industry_drop?scene=2`.\n\nAPI references: `x_huo_industry_drop` = `GET /tikhub/bilibili/huahuo/x_huo_industry_drop` (operationId: `get_tikhub_bilibili_huahuo_x_huo_industry_drop`).", "title": "X Huo Industry Id" }, "description": "Industry ID; valid values from x_huo_industry_drop?scene=2\n\nUsage: Required product-ranking industry ID from\n `x_huo_industry_drop?scene=2`.\n\nAPI references: `x_huo_industry_drop` = `GET /tikhub/bilibili/huahuo/x_huo_industry_drop` (operationId: `get_tikhub_bilibili_huahuo_x_huo_industry_drop`)." } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:f7308c2a43020b3c294a043fd8fea040664c5b21204473bd65fa6690699f28b5" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-huahuo-popular_goods_industry_up_list" } }, "/apis/v1/tikhub/bilibili/huahuo/popular_goods_list": { "get": { "description": "Bilibili (huahuo). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Retrieve X-Huo product rankings for an industry and analyze popular\n products and their content-commerce performance.\n\n### Parameters\n- `x_huo_industry_id`: Required product-ranking industry ID from\n `x_huo_industry_drop?scene=2`.\n- `page`: One-based page number.\n- `rank_type`, `data_cycle`: Optional ranking mode and data period.\n- `min_goods_price`, `max_goods_price`: Optional product price range.\n\n### Returns\n- Product ranks, product details, pricing, industry, commerce-performance\n metrics, and pagination information.\n\n### Billing\n\nAPI references: `x_huo_industry_drop` = `GET /tikhub/bilibili/huahuo/x_huo_industry_drop` (operationId: `get_tikhub_bilibili_huahuo_x_huo_industry_drop`).\n\n\nPublished reference price: $0.006 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_huahuo_popular_goods_list", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Product ranks, product details, pricing, industry, commerce-performance\n metrics, and pagination information.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili popular_goods_list", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.006, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "453267e99c3f" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/huahuo/popular_goods_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_huahuo_popular_goods_list", "method": "GET", "path": "/apis/v1/tikhub/bilibili/huahuo/popular_goods_list" }, "parameters": [ { "name": "data_cycle", "in": "query", "required": false, "schema": { "description": "Data period", "title": "Data Cycle", "type": [ "integer", "null" ] }, "description": "Data period" }, { "name": "max_goods_price", "in": "query", "required": false, "schema": { "description": "Maximum product price", "title": "Max Goods Price", "type": [ "integer", "null" ] }, "description": "Maximum product price" }, { "name": "min_goods_price", "in": "query", "required": false, "schema": { "description": "Minimum product price", "title": "Min Goods Price", "type": [ "integer", "null" ] }, "description": "Minimum product price" }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "default": 1, "title": "Page" }, "description": "One-based page number." }, { "name": "rank_type", "in": "query", "required": false, "schema": { "description": "Ranking scope", "title": "Rank Type", "type": [ "integer", "null" ] }, "description": "Ranking scope" }, { "name": "x_huo_industry_id", "in": "query", "required": true, "schema": { "type": "integer", "description": "Industry ID; valid values from x_huo_industry_drop?scene=2\n\nUsage: Required product-ranking industry ID from\n `x_huo_industry_drop?scene=2`.\n\nAPI references: `x_huo_industry_drop` = `GET /tikhub/bilibili/huahuo/x_huo_industry_drop` (operationId: `get_tikhub_bilibili_huahuo_x_huo_industry_drop`).", "title": "X Huo Industry Id" }, "description": "Industry ID; valid values from x_huo_industry_drop?scene=2\n\nUsage: Required product-ranking industry ID from\n `x_huo_industry_drop?scene=2`.\n\nAPI references: `x_huo_industry_drop` = `GET /tikhub/bilibili/huahuo/x_huo_industry_drop` (operationId: `get_tikhub_bilibili_huahuo_x_huo_industry_drop`)." } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:6f4ad06577b9401913a282a71bcec6c14e8ae36475f0cc163cb0c263ee084cb2" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-huahuo-popular_goods_list" } }, "/apis/v1/tikhub/bilibili/huahuo/popular_goods_up_list": { "get": { "description": "Bilibili (huahuo). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Find creators with strong commerce performance for a specific product.\n\n### Parameters\n- `goods_id`: Required product ID from `popular_goods_list`.\n- `page`: One-based page number.\n\n### Returns\n- Creator ranks, profiles, product-specific commerce metrics, and pagination information.\n\n### Billing\n\nAPI references: `popular_goods_list` = `GET /tikhub/bilibili/huahuo/popular_goods_list` (operationId: `get_tikhub_bilibili_huahuo_popular_goods_list`).\n\n\nPublished reference price: $0.006 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_huahuo_popular_goods_up_list", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Creator ranks, profiles, product-specific commerce metrics, and pagination information.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili popular_goods_up_list", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.006, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "3bb03cda423a" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/huahuo/popular_goods_up_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_huahuo_popular_goods_up_list", "method": "GET", "path": "/apis/v1/tikhub/bilibili/huahuo/popular_goods_up_list" }, "parameters": [ { "name": "goods_id", "in": "query", "required": true, "schema": { "type": "integer", "description": "Product ID, see popular_goods_list for values\n\nUsage: Required product ID from `popular_goods_list`.\n\nAPI references: `popular_goods_list` = `GET /tikhub/bilibili/huahuo/popular_goods_list` (operationId: `get_tikhub_bilibili_huahuo_popular_goods_list`).", "title": "Goods Id" }, "description": "Product ID, see popular_goods_list for values\n\nUsage: Required product ID from `popular_goods_list`.\n\nAPI references: `popular_goods_list` = `GET /tikhub/bilibili/huahuo/popular_goods_list` (operationId: `get_tikhub_bilibili_huahuo_popular_goods_list`)." }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "default": 1, "title": "Page" }, "description": "One-based page number." } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:3f40230c8703b4e36dba035e4649de374dd6a4ea56cd2f8c9cafc6351d587563" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-huahuo-popular_goods_up_list" } }, "/apis/v1/tikhub/bilibili/huahuo/popular_up_list": { "get": { "description": "Bilibili (huahuo). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Retrieve breakout, high-value, or top-tier creator rankings for rapid discovery.\n\n### Parameters\n- `rank_cate`: Ranking type: `1` breakout creators, `2` high-value creators,\n or `3` top-tier creators.\n- `tid_name`: Ranking category from `popular_up_tid_drop`; an empty string means all.\n- `page`: One-based page number.\n\n### Returns\n- Creator ranks, profiles, and category-specific metrics. Breakout rankings\n emphasize follower growth, high-value rankings emphasize median playback\n and engagement, and top-tier rankings emphasize average metrics.\n\n### Billing\n\nAPI references: `popular_up_tid_drop` = `GET /tikhub/bilibili/huahuo/popular_up_tid_drop` (operationId: `get_tikhub_bilibili_huahuo_popular_up_tid_drop`).\n\n\nPublished reference price: $0.006 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_huahuo_popular_up_list", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Creator ranks, profiles, and category-specific metrics. Breakout rankings\n emphasize follower growth, high-value rankings emphasize median playback\n and engagement, and top-tier rankings emphasize average metrics.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili popular_up_list", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.006, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "6fc3f6e373bd" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/huahuo/popular_up_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_huahuo_popular_up_list", "method": "GET", "path": "/apis/v1/tikhub/bilibili/huahuo/popular_up_list" }, "parameters": [ { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "default": 1, "title": "Page" }, "description": "One-based page number." }, { "name": "rank_cate", "in": "query", "required": false, "schema": { "type": "integer", "description": "Ranking type: 1=Rising Stars, 2=Best Value Picks, 3=Top Must-haves\n\nUsage: Ranking type: `1` breakout creators, `2` high-value creators,\n or `3` top-tier creators.", "default": 3, "title": "Rank Cate" }, "description": "Ranking type: 1=Rising Stars, 2=Best Value Picks, 3=Top Must-haves\n\nUsage: Ranking type: `1` breakout creators, `2` high-value creators,\n or `3` top-tier creators." }, { "name": "tid_name", "in": "query", "required": false, "schema": { "type": "string", "description": "Ranking section name; see popular_up_tid_drop for values; leave empty for all\n\nUsage: Ranking category from `popular_up_tid_drop`; an empty string means all.\n\nAPI references: `popular_up_tid_drop` = `GET /tikhub/bilibili/huahuo/popular_up_tid_drop` (operationId: `get_tikhub_bilibili_huahuo_popular_up_tid_drop`).", "default": "", "title": "Tid Name" }, "description": "Ranking section name; see popular_up_tid_drop for values; leave empty for all\n\nUsage: Ranking category from `popular_up_tid_drop`; an empty string means all.\n\nAPI references: `popular_up_tid_drop` = `GET /tikhub/bilibili/huahuo/popular_up_tid_drop` (operationId: `get_tikhub_bilibili_huahuo_popular_up_tid_drop`)." } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:43f68d8ec27a178e4e70dbf44fb9fb2428a757d66f810a443911dae7235d6a8d" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-huahuo-popular_up_list" } }, "/apis/v1/tikhub/bilibili/huahuo/popular_up_tid_drop": { "get": { "description": "Bilibili (huahuo). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get content categories accepted by `popular_up_list` as `tid_name` values.\n\n### Parameters\n- None.\n\n### Returns\n- Available ranking category names and display information.\n\n### Billing\n\nAPI references: `popular_up_list` = `GET /tikhub/bilibili/huahuo/popular_up_list` (operationId: `get_tikhub_bilibili_huahuo_popular_up_list`).\n\n\nPublished reference price: $0.006 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_huahuo_popular_up_tid_drop", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Available ranking category names and display information.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili popular_up_tid_drop", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.006, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a06894d51e2c" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/huahuo/popular_up_tid_drop", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_huahuo_popular_up_tid_drop", "method": "GET", "path": "/apis/v1/tikhub/bilibili/huahuo/popular_up_tid_drop" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:67bbd97543e4cb8eb75a27adc3e2e6fb442d6a63dd948204910090b127ec40df" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-huahuo-popular_up_tid_drop" } }, "/apis/v1/tikhub/bilibili/huahuo/popular_up_x_huo": { "get": { "description": "Bilibili (huahuo). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Retrieve X-Huo creator rankings for a selected industry and period for\n creator selection and industry trend analysis.\n\n### Parameters\n- `x_huo_industry_id`: Required industry ID from\n `x_huo_industry_drop?scene=1`; prefer the second-level ID when available.\n- `rank_date_type`: `1` monthly or `2` quarterly.\n- `rank_date`: Ranking period in `YYYY-MM` format from `x_huo_date_options`;\n omit it to use the latest completed period.\n- `page`: One-based page number.\n\n### Returns\n- Creator ranks, profiles, industry relevance, content-influence metrics,\n and pagination information.\n\n### Billing\n\nAPI references: `x_huo_date_options` = `GET /tikhub/bilibili/huahuo/x_huo_date_options` (operationId: `get_tikhub_bilibili_huahuo_x_huo_date_options`); `x_huo_industry_drop` = `GET /tikhub/bilibili/huahuo/x_huo_industry_drop` (operationId: `get_tikhub_bilibili_huahuo_x_huo_industry_drop`).\n\n\nPublished reference price: $0.006 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_huahuo_popular_up_x_huo", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Creator ranks, profiles, industry relevance, content-influence metrics,\n and pagination information.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili popular_up_x_huo", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.006, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "28b095e9683f" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/huahuo/popular_up_x_huo", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_huahuo_popular_up_x_huo", "method": "GET", "path": "/apis/v1/tikhub/bilibili/huahuo/popular_up_x_huo" }, "parameters": [ { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "default": 1, "title": "Page" }, "description": "One-based page number." }, { "name": "rank_date", "in": "query", "required": false, "schema": { "description": "Ranking issue `YYYY-MM`; see x_huo_date_options for values; leave empty for the latest issue\n\nUsage: Ranking period in `YYYY-MM` format from `x_huo_date_options`;\n omit it to use the latest completed period.\n\nAPI references: `x_huo_date_options` = `GET /tikhub/bilibili/huahuo/x_huo_date_options` (operationId: `get_tikhub_bilibili_huahuo_x_huo_date_options`).", "title": "Rank Date", "type": [ "string", "null" ] }, "description": "Ranking issue `YYYY-MM`; see x_huo_date_options for values; leave empty for the latest issue\n\nUsage: Ranking period in `YYYY-MM` format from `x_huo_date_options`;\n omit it to use the latest completed period.\n\nAPI references: `x_huo_date_options` = `GET /tikhub/bilibili/huahuo/x_huo_date_options` (operationId: `get_tikhub_bilibili_huahuo_x_huo_date_options`)." }, { "name": "rank_date_type", "in": "query", "required": false, "schema": { "type": "integer", "description": "Ranking period: 1=Monthly, 2=Quarterly\n\nUsage: `1` monthly or `2` quarterly.", "default": 1, "title": "Rank Date Type" }, "description": "Ranking period: 1=Monthly, 2=Quarterly\n\nUsage: `1` monthly or `2` quarterly." }, { "name": "x_huo_industry_id", "in": "query", "required": true, "schema": { "type": "integer", "description": "Industry ID; valid values from x_huo_industry_drop\n\nUsage: Required industry ID from\n `x_huo_industry_drop?scene=1`; prefer the second-level ID when available.\n\nAPI references: `x_huo_industry_drop` = `GET /tikhub/bilibili/huahuo/x_huo_industry_drop` (operationId: `get_tikhub_bilibili_huahuo_x_huo_industry_drop`).", "title": "X Huo Industry Id" }, "description": "Industry ID; valid values from x_huo_industry_drop\n\nUsage: Required industry ID from\n `x_huo_industry_drop?scene=1`; prefer the second-level ID when available.\n\nAPI references: `x_huo_industry_drop` = `GET /tikhub/bilibili/huahuo/x_huo_industry_drop` (operationId: `get_tikhub_bilibili_huahuo_x_huo_industry_drop`)." } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:b289d5f776d37ca3cf70a3b0324f3d38a33dd5fcf388e89775f5f82343162767" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-huahuo-popular_up_x_huo" } }, "/apis/v1/tikhub/bilibili/huahuo/region_drop": { "get": { "description": "Bilibili (huahuo). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Retrieve the province/city hierarchy used by creator residence filters.\n\n### Parameters\n- None.\n\n### Returns\n- Put selected primary-node `value`s in `search_upper.region_id`, and selected\n `children[].value`s in `search_upper.second_region_id`.\n- For multiple selections, collect all values in their respective arrays. For\n example: `{\"region_id\":[4,5,23],\"second_region_id\":[51,50]}`.\n\n### Example\n`GET /tikhub/bilibili/huahuo/region_drop`\n\n### Billing\n\nAPI references: `search_upper` = `POST /tikhub/bilibili/huahuo/search_upper` (operationId: `post_tikhub_bilibili_huahuo_search_upper`).\n\n\nPublished reference price: $0.006 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_huahuo_region_drop", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Put selected primary-node `value`s in `search_upper.region_id`, and selected\n `children[].value`s in `search_upper.second_region_id`.\n- For multiple selections, collect all values in their respective arrays. For\n example: `{\"region_id\":[4,5,23],\"second_region_id\":[51,50]}`.\n\nAPI references: `search_upper` = `POST /tikhub/bilibili/huahuo/search_upper` (operationId: `post_tikhub_bilibili_huahuo_search_upper`).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili region_drop", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.006, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "93c3118bb870" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/huahuo/region_drop", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_huahuo_region_drop", "method": "GET", "path": "/apis/v1/tikhub/bilibili/huahuo/region_drop" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:d8550bb0aa5c6b337a18846078d212ccfcd42515b78030f160370e726b2d7e12" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-huahuo-region_drop" } }, "/apis/v1/tikhub/bilibili/huahuo/search_live_upper": { "post": { "description": "Bilibili (huahuo). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Search live creators for branded-content or live-commerce collaborations.\n- Filter by creator attributes, audience demographics, live categories,\n performance, guild, primary commerce category, and GMV.\n\n### Parameters\n- `is_brand_live`: Live mode. Use `1` for branded-content live streams and\n `0` for commerce live streams.\n- Branded-content mode supports popularity peak, hourly viewers, hourly\n comments, guild, and onboarding-status filters.\n- Commerce mode supports primary category and 90-day GMV filters.\n- `page`: One-based page number. Each page contains 20 records.\n\n### Returns\n- `total_count`: Total number of matching creators.\n- `data`: Creator records containing profile, audience, live performance,\n and collaboration-capability metrics.\n\n### Billing\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_bilibili_huahuo_search_live_upper", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- `total_count`: Total number of matching creators.\n- `data`: Creator records containing profile, audience, live performance,\n and collaboration-capability metrics.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili search_live_upper", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "40a1880285fa" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/huahuo/search_live_upper", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_bilibili_huahuo_search_live_upper", "method": "POST", "path": "/apis/v1/tikhub/bilibili/huahuo/search_live_upper" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "nickname_or_mids": { "title": "Nickname Or Mids", "description": "Search by creator nickname or UID", "type": [ "string", "null" ] }, "mids": { "title": "Mids", "description": "Batch exact match by UID", "items": { "type": "integer" }, "type": [ "array", "null" ] }, "is_brand_live": { "title": "Is Brand Live", "description": "Live stream type: 1=Content live stream, 0=Commerce live stream. Available filters differ between the two types.", "type": [ "integer", "null" ] }, "gender": { "title": "Gender", "description": "Anchor gender", "type": [ "string", "null" ] }, "region_id": { "title": "Region Id", "description": "Anchor primary residence region (level 1)", "items": { "type": "integer" }, "type": [ "array", "null" ] }, "second_region_id": { "title": "Second Region Id", "description": "Anchor primary residence region (level 2)", "items": { "type": "integer" }, "type": [ "array", "null" ] }, "min_fans_num": { "title": "Min Fans Num", "description": "Minimum follower count", "type": [ "integer", "null" ] }, "max_fans_num": { "title": "Max Fans Num", "description": "Maximum follower count", "type": [ "integer", "null" ] }, "fans_gender_tag": { "title": "Fans Gender Tag", "description": "Audience gender tag", "items": { "type": "string" }, "type": [ "array", "null" ] }, "fans_age_tag": { "title": "Fans Age Tag", "description": "Audience age tag", "items": { "type": "string" }, "type": [ "array", "null" ] }, "fans_region_tag": { "title": "Fans Region Tag", "description": "Audience region tag", "items": { "type": "string" }, "type": [ "array", "null" ] }, "live_subarea_id": { "title": "Live Subarea Id", "description": "Live area (second-level); see live_area_list for values\n\nAPI references: `live_area_list` = `GET /tikhub/bilibili/huahuo/live_area_list` (operationId: `get_tikhub_bilibili_huahuo_live_area_list`).", "items": { "type": "integer" }, "type": [ "array", "null" ] }, "partition_id": { "title": "Partition Id", "description": "Submission category (level 1)", "type": [ "integer", "null" ] }, "second_partition_id": { "title": "Second Partition Id", "description": "Submission category (level 2)", "items": { "type": "integer" }, "type": [ "array", "null" ] }, "min_popularity": { "title": "Min Popularity", "description": "Minimum average peak popularity per session in the last 30 days", "type": [ "integer", "null" ] }, "max_popularity": { "title": "Max Popularity", "description": "Maximum average peak popularity per session in the last 30 days", "type": [ "integer", "null" ] }, "live_audience_h_avg_30d_min": { "title": "Live Audience H Avg 30D Min", "description": "Minimum average hourly viewer count in the last 30 days", "type": [ "integer", "null" ] }, "live_audience_h_avg_30d_max": { "title": "Live Audience H Avg 30D Max", "description": "Maximum average hourly viewer count in the last 30 days", "type": [ "integer", "null" ] }, "live_danmu_h_avg_30d_min": { "title": "Live Danmu H Avg 30D Min", "description": "Minimum average hourly danmaku count in the last 30 days", "type": [ "integer", "null" ] }, "live_danmu_h_avg_30d_max": { "title": "Live Danmu H Avg 30D Max", "description": "Maximum average hourly danmaku count in the last 30 days", "type": [ "integer", "null" ] }, "live_guild_id": { "title": "Live Guild Id", "description": "Live streaming guild; see live_guild_drop for values\n\nAPI references: `live_guild_drop` = `GET /tikhub/bilibili/huahuo/live_guild_drop` (operationId: `get_tikhub_bilibili_huahuo_live_guild_drop`).", "items": { "type": "integer" }, "type": [ "array", "null" ] }, "high_potential_type": { "title": "High Potential Type", "description": "Registration status", "type": [ "integer", "null" ] }, "live_good_category": { "title": "Live Good Category", "description": "Primary commerce category; 0=all; valid values from live_good_category\n\nAPI references: `live_good_category` = `GET /tikhub/bilibili/huahuo/live_good_category` (operationId: `get_tikhub_bilibili_huahuo_live_good_category`).", "type": [ "integer", "null" ] }, "live_good_gmv": { "title": "Live Good Gmv", "description": "90-day GMV tier, 0=all", "type": [ "integer", "null" ] }, "order_by": { "title": "Order By", "description": "Sort field", "type": [ "string", "null" ] }, "sort": { "title": "Sort", "description": "Sort direction: desc or asc", "type": [ "string", "null" ] }, "page": { "title": "Page", "description": "Page number starting from 1; 20 items per page\n\nUsage: One-based page number. Each page contains 20 records.", "type": [ "integer", "null" ], "minimum": 1.0 } }, "additionalProperties": true, "type": "object", "title": "LiveSearchBody", "description": "Live collaboration marketplace filters. Supports creator attributes,\naudience demographics, live categories, content-live performance,\ncommerce categories, and GMV filters. Every field is optional, and\nadditional filter fields may be supplied." } } } }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:a42f5db246199f81f1bb96c023ed85e6a094a199ee570496e2d0667bb238a1fd" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-bilibili-huahuo-search_live_upper" } }, "/apis/v1/tikhub/bilibili/huahuo/search_upper": { "post": { "description": "Bilibili (huahuo). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Search creators by nickname, UID, or content keyword in the Huahuo marketplace.\n- Combine profile, audience, pricing, performance, DMP, industry,\n cooperation-experience, and commerce filters.\n- `nickname_or_mids` and `main_search` correspond to creator search and\n content search respectively; normally choose one per request.\n\n### Parameters\n#### Basic search parameters:\n- `nickname_or_mids`: Creator nickname or UID query; separate multiple terms with commas.\n- `main_search`: Content-keyword query with matched videos included in the result.\n Normally use either this field or `nickname_or_mids`.\n- `mids`: Exact UID list; `upper_mid`: One exact UID; `folder_id`: Saved-creator folder ID.\n- `marketing_target`: `1`=brand awareness, `2`=consideration, `3`=conversion.\n- `panel_type`: `0`=general, `1`=gaming, `2`=beauty, `3`=digital,\n `4`=automotive, `5`=performance, `6`=food, `8`=internet services.\n- `order_by`: Sort field; `sort`: `desc` or `asc`; `page`: One-based page number\n with 20 results per page; `request_id`: Optional search-session ID that can\n be reused across pages with the same filters.\n\n#### Creator profile and affiliation parameters:\n- `gender`: Value from `square_static_info.gender_info`.\n- `min_fans_num` / `max_fans_num`: Inclusive follower-count range.\n- `region_id` / `second_region_id`: Primary and secondary residence-region IDs\n from `region_drop`. The Beijing, Shanghai, Fujian, Xiamen, and\n Fuzhou selection is `{\"region_id\":[4,5,23],\"second_region_id\":[51,50]}`.\n- `partition_id` / `second_partition_id`: Primary and secondary content-category IDs.\n- `mcn_ids`: MCN IDs; `provider_id`: Service-provider IDs.\n- `upper_types`: `1` or `4`=MCN-affiliated, `3`=independent.\n- `only_contract`: `1`=contract-eligible creators only, `0`=all.\n- `is_painter_order`: Require illustration-commission capability.\n\n#### Audience and DMP parameters:\n- `fans_age_tag`, `fans_gender_tag`, `fans_region_tag`: Audience age, gender,\n and region affinity tags; `fans_stick`: Follower-loyalty tier.\n- `av_active`: Enable recent-publishing filtering; `av_active_tag`: Activity tier.\n- `dmp_group_id`: Custom DMP package ID; `category_dmp_group_id` and\n `category_dmp_label`: Category-package ID and display label.\n- `dmp_pkg_name`: Special-audience package name query.\n- `dmp_pkg_vertical_rate_gte` / `dmp_pkg_vertical_rate_lte`: DMP verticality range,\n measured as matching videos divided by all videos in the last 180 days.\n- `dmp_pkg_effect_rate_gte` / `dmp_pkg_effect_rate_lte`: DMP influence range,\n measured as recent matching viewers divided by that audience population.\n- `dmp_pkg_fan_rate_gte` / `dmp_pkg_fan_rate_lte`: DMP attention range,\n measured as matching audience members divided by all followers.\n\n#### Pricing and performance parameters:\n- `min_task_price` / `max_task_price`: Standard cooperation quote range in RMB.\n- `price_info`: Cooperation-specific pricing array; the current UI submits\n one selected cooperation type per search. Each item contains:\n - `cooperation_type`: Video cooperation uses `1`=embedded video,\n `2`=custom video, and `22`=deep customization; podcast cooperation\n uses `23`=custom podcast and `24`=podcast brand placement; dynamic\n cooperation uses `3`=direct post and `4`=repost. Placement formats\n embed brand material in the content, custom formats are produced for\n the client's marketing needs, and dynamic formats publish or repost\n the requested commercial post.\n - `price_min` / `price_max`: Quote range in RMB for that cooperation type.\n - `creative_skill`: Deep-customization skill IDs `1-9`, covering overseas\n filming, technical analysis, microfilm, live-action challenge,\n renovation/DIY, interview, TVC filming, special editing, and other.\n - `include_content`: Included-content IDs for custom video, deep\n customization, or custom podcast: `1`=secondary creation/distribution\n license, `2`=bonus preview, `3`=custom content.\n - `price_right`: Cooperation-right codes. Types `1/2/23/24` support\n `show_in_video_first_1p3` and `show_in_video_gte_30s`; type `22`\n supports `brand_over_30_percent`, `auth_secondary_creation`,\n `multi_cooperation_discount`, `give_preview`, and `give_poster`.\n Types `3/4` do not support this field and use `[]`.\n - Every `price_info` item contains all six fields. Send `[]` for an\n unavailable or unselected `creative_skill`, `include_content`, or\n `price_right`. “RMB 100,000 or more” is\n `\"price_min\":100000,\"price_max\":\"\"`.\n - Deep-custom example:\n `{\"price_info\":[{\"cooperation_type\":22,\"creative_skill\":[1,2,3],`\n `\"include_content\":[1,2,3],\"price_min\":100000,\"price_max\":\"\",`\n `\"price_right\":[]}]}`.\n - Embedded-video example:\n `{\"price_info\":[{\"cooperation_type\":1,\"creative_skill\":[],`\n `\"include_content\":[],\"price_min\":100000,\"price_max\":\"\",\"price_right\":[]}]}`.\n - Custom-podcast example:\n `{\"price_info\":[{\"cooperation_type\":23,\"creative_skill\":[],`\n `\"include_content\":[1],\"price_min\":100000,\"price_max\":\"\",\"price_right\":[]}]}`.\n - Direct-post example:\n `{\"price_info\":[{\"cooperation_type\":3,\"creative_skill\":[],`\n `\"include_content\":[],\"price_min\":100000,\"price_max\":\"\",\"price_right\":[]}]}`.\n - Call `GET /tikhub/bilibili/huahuo/square_static_info` first and read\n `data.price_info_options` for cooperation types, price ranges, rights,\n included content, and creative skills. Each item in\n `cooperation_type` declares its usable request fields in `supported_fields`.\n- `last_7_days_set_price`, `last_14_days_set_price`, `last_30_days_set_price`:\n `1` requires a quote set in the selected period; `0` means unrestricted.\n- `min_interact_rate` / `max_interact_rate`: Engagement-rate range for eligible\n original videos in the last 180 days.\n- `blue_url_ctr_gte` / `blue_url_ctr_lt`: Blue-link CTR range;\n `blue_url_click_cost_gte` / `blue_url_click_cost_lt`: Blue-link click-cost range.\n- `min_play_median` / `max_play_median`: Median-view range for eligible original\n videos published at least seven days ago.\n- `play_median_traffic_type`: `1`=all, `2`=organic;\n `play_median_cycle`: `1/2/3`=7/15/30 days.\n Example for “300,000-500,000, 15 days, organic”:\n `{\"min_play_median\":\"300000\",\"max_play_median\":\"500000\",`\n `\"play_median_traffic_type\":2,\"play_median_cycle\":2}`.\n- `min_cpm` / `max_cpm`: CPM range; `cpm_type`: `1`=all, `2`=organic;\n `cpm_cycle`: `1/2/3`=7/15/30 days.\n- `min_cpc` / `max_cpc`: CPC range; `cpc_traffic_type`: `1`=all, `2`=organic;\n `cpc_cycle`: `1/2/3`=7/15/30 days.\n- `cpe_gte` / `cpe_lt`: CPE range; `cpe_traffic_type`: `1`=all, `2`=organic;\n `cpe_cycle`: `1`=7 days, `3`=30 days.\n\n#### Content and cooperation parameters:\n- `draft_duration`: Dominant video duration: `1`=0-30s, `2`=30-60s,\n `3`=1-3m, `4`=3-5m, `5`=5-10m, `6`=over 10m.\n- `min_avid_cnt` / `max_avid_cnt`: Eligible original-video count range over 90 days.\n- `min_hot_avid_rate` / `max_hot_avid_rate`: Viral-video ratio range over 90 days.\n- `half_min_hot_avid_cnt` / `half_max_hot_avid_cnt`: Viral-video count range over six months.\n- `entry_cost_min` / `entry_cost_max`: Store-entry cost range over the last year.\n- `av_honor`: Honor filter containing a multi-select `honor_type` array\n (`HOT`, `MZBK`, and/or `QZPHB`), `time_period` (`0/30/90/180` days), and\n `honor_count` (`0/1/2/3`, where 3 means 3+). Multi-select example:\n `{\"av_honor\":{\"honor_type\":[\"HOT\",\"QZPHB\"],\"time_period\":90,`\n `\"honor_count\":2}}`.\n- The general panel's cooperation-count filter uses `spark_tag`:\n `cooperate`=experienced or `coo_frequent`=extensive experience; choose one.\n Cooperation industries come from `square_static_info.industry_tree`; send\n selected paths in `huahuo_first_industry_ids`, `huahuo_second_industry_ids`,\n and `huahuo_third_industry_ids`. For “real estate/all with experience”:\n `{\"spark_tag\":[\"cooperate\"],\"huahuo_first_industry_ids\":[\"388\"],`\n `\"huahuo_second_industry_ids\":[\"389\",\"393\",\"399\",\"401\",\"403\"],`\n `\"huahuo_third_industry_ids\":[\"390\",\"394\",\"395\",\"396\",\"398\",`\n `\"400\",\"402\",\"404\"]}`. Merge IDs from all selected paths for a\n multi-industry request.\n- Non-general strategy panels use `cooperate_experience_industry_ids` with\n `cooperate_experience_type`. Without selected industries, the type options are\n `3`=no current-industry experience, `1`=experienced, `2`=extensive experience,\n and `4`=experience in other industries. With selected industries, use `1` or `2`.\n `cooperate_experience_industry` supplies those strategy-panel industry values.\n\n#### Labels and industry parameters:\n- `special_tags`: Feature tags; `spark_tag`: Capability tags such as `cooperate`,\n `grow`, and `hot_frequent`; `square_tag_in`: Marketplace scenario tags.\n- `label_array`: Contains only selected node `value`s from the “Content type”\n group returned by `upper_label_tree`. Put all selected content types in one\n inner array without parent-path values. Single “Outdoor adventure” selection:\n `{\"label_array\":[[794]]}`; multiple “Outdoor adventure, AI short film,\n AI entertainment” selections: `{\"label_array\":[[794,747,748]]}`.\n- `bdata_tag_lv5`: Bilibili level-five content-tag values.\n- `huahuo_first_industry_ids`, `huahuo_second_industry_ids`,\n `huahuo_third_industry_ids`: Primary, secondary, and tertiary Huahuo industry IDs.\n\n#### Commerce parameters:\n- `goods_permission`: `1`=require commerce permission, `0`=all;\n `goods_up_levels`: Commerce-creator levels.\n- `goods_category_first_ids` / `goods_category_second_ids`: Commerce-category IDs.\n- `goods_gpm_min` / `goods_gpm_max`: 30-day paid GMV per 1,000 commerce-video views.\n- `goods_ctr_min` / `goods_ctr_max`: Component CTR range;\n `goods_ctr_type`: `1`=all components, `2`=comment component.\n- `goods_avg_price_min` / `goods_avg_price_max`: 30-day average product-price range in RMB.\n- `goods_is_high_video_play_permeate`: Require high video-view penetration;\n `goods_is_high_fans_play_permeate`: Require high follower-view penetration.\n\n#### Status and high-potential parameters:\n- `is_boosting`: Require currently boosted creators; `is_treasure_up`: Treasure creators;\n `is_timely_response`: Timely-response creators; `is_new_enter`: Newly onboarded creators.\n- `custom_video_pricing_set`: Require configured custom-video pricing;\n `is_x_plan_better_up`: X Plan preferred creators.\n- `high_potential_type`: `0`=all, `1`=onboarded, `2`=not onboarded.\n\n#### Filter value sources:\n- Content types: call\n `GET /tikhub/bilibili/huahuo/upper_label_tree?panel_type=0`, read node\n `value`s from the Content type group, and build `label_array`.\n- Residence regions: call `GET /tikhub/bilibili/huahuo/region_drop`; use\n primary `value`s in `region_id` and selected child `value`s in\n `second_region_id`.\n- General-panel cooperation industries: call\n `GET /tikhub/bilibili/huahuo/square_static_info`, read the three-level\n `data.industry_tree`, and fill the matching `huahuo_*_industry_ids` arrays.\n Use `spark_tag` with `cooperate` or `coo_frequent` for cooperation count.\n- Non-general-panel cooperation experience: call\n `GET /tikhub/bilibili/huahuo/cooperate_experience_industry?industry_type=`,\n then set `cooperate_experience_industry_ids` and `cooperate_experience_type`.\n- Cooperation pricing: call `GET /tikhub/bilibili/huahuo/square_static_info`,\n read `data.price_info_options`, and build `price_info`. Median views and\n video honors use the fixed enums and Request Payload Examples documented here.\n- Other dynamic sources: call `GET /tikhub/bilibili/huahuo/square_static_info`\n for audience, gender, activity, and feature tags;\n `GET /tikhub/bilibili/huahuo/partition_drop` for first- and second-level\n video categories; `GET /tikhub/bilibili/huahuo/mcn_drop?name=` for MCNs;\n `GET /tikhub/bilibili/huahuo/dmp_pkg_list` for custom DMP packages; and\n `GET /tikhub/bilibili/huahuo/effect_goods_drop` for commerce categories.\n\n### Returns\n- `page`: Current page number.\n- `total_count`: Total matching records, displayed up to 10,000.\n- `data`: Creator records commonly containing `upper_mid`, `nickname`,\n `fans_num`, `play_median`, `interactive_rate`, pricing, content and\n industry labels, DMP measurements, and commerce metrics. Content-search\n results also include matched videos.\n\n### Billing\n\nAPI references: `cooperate_experience_industry` = `GET /tikhub/bilibili/huahuo/cooperate_experience_industry` (operationId: `get_tikhub_bilibili_huahuo_cooperate_experience_industry`); `dmp_pkg_list` = `GET /tikhub/bilibili/huahuo/dmp_pkg_list` (operationId: `get_tikhub_bilibili_huahuo_dmp_pkg_list`); `effect_goods_drop` = `GET /tikhub/bilibili/huahuo/effect_goods_drop` (operationId: `get_tikhub_bilibili_huahuo_effect_goods_drop`); `mcn_drop` = `GET /tikhub/bilibili/huahuo/mcn_drop` (operationId: `get_tikhub_bilibili_huahuo_mcn_drop`); `partition_drop` = `GET /tikhub/bilibili/huahuo/partition_drop` (operationId: `get_tikhub_bilibili_huahuo_partition_drop`); `region_drop` = `GET /tikhub/bilibili/huahuo/region_drop` (operationId: `get_tikhub_bilibili_huahuo_region_drop`); `square_static_info` = `GET /tikhub/bilibili/huahuo/square_static_info` (operationId: `get_tikhub_bilibili_huahuo_square_static_info`); `upper_label_tree` = `GET /tikhub/bilibili/huahuo/upper_label_tree` (operationId: `get_tikhub_bilibili_huahuo_upper_label_tree`).\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_bilibili_huahuo_search_upper", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- `page`: Current page number.\n- `total_count`: Total matching records, displayed up to 10,000.\n- `data`: Creator records commonly containing `upper_mid`, `nickname`,\n `fans_num`, `play_median`, `interactive_rate`, pricing, content and\n industry labels, DMP measurements, and commerce metrics. Content-search\n results also include matched videos.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili search_upper", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "672a5e939147" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/huahuo/search_upper", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_bilibili_huahuo_search_upper", "method": "POST", "path": "/apis/v1/tikhub/bilibili/huahuo/search_upper" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "nickname_or_mids": { "title": "Nickname Or Mids", "description": "Creator nickname or UID query; separate multiple terms with commas", "type": [ "string", "null" ] }, "main_search": { "title": "Main Search", "description": "Content-keyword query; matched videos are included in the result", "type": [ "string", "null" ] }, "mids": { "title": "Mids", "description": "List of creator UIDs to match exactly", "items": { "anyOf": [ { "type": "integer" }, { "type": "string" } ] }, "type": [ "array", "null" ] }, "upper_mid": { "title": "Upper Mid", "description": "Single creator UID for an exact match", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "string" } ], "title": "Upper Mid", "description": "Single creator UID for an exact match" }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "folder_id": { "title": "Folder Id", "description": "Saved-creator folder ID used to limit the search", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "string" } ], "title": "Folder Id", "description": "Saved-creator folder ID used to limit the search" }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "marketing_target": { "title": "Marketing Target", "description": "Marketing objective: 1=brand awareness, 2=consideration, 3=conversion", "type": [ "integer", "null" ] }, "panel_type": { "title": "Panel Type", "description": "Strategy panel: 0=general, 1=gaming, 2=beauty, 3=digital, 4=automotive, 5=performance, 6=food, 8=internet", "type": [ "integer", "null" ] }, "order_by": { "title": "Order By", "description": "Sort field, such as fans_num, play_median, or interactive_rate", "type": [ "string", "null" ] }, "sort": { "title": "Sort", "description": "Sort direction: desc=descending, asc=ascending", "type": [ "string", "null" ] }, "page": { "title": "Page", "description": "Page number starting at 1; each page contains 20 records.", "type": [ "integer", "null" ], "minimum": 1.0 }, "request_id": { "title": "Request Id", "description": "Search-session ID; reuse it across pages of the same filter set", "type": [ "string", "null" ] }, "gender": { "title": "Gender", "description": "Creator gender from gender_info returned by /tikhub/bilibili/huahuo/square_static_info\n\nAPI references: `square_static_info` = `GET /tikhub/bilibili/huahuo/square_static_info` (operationId: `get_tikhub_bilibili_huahuo_square_static_info`).", "type": [ "string", "null" ] }, "min_fans_num": { "title": "Min Fans Num", "description": "Minimum follower count, inclusive", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "string" } ], "title": "Min Fans Num", "description": "Minimum follower count, inclusive" }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "max_fans_num": { "title": "Max Fans Num", "description": "Maximum follower count, inclusive", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "string" } ], "title": "Max Fans Num", "description": "Maximum follower count, inclusive" }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "region_id": { "title": "Region Id", "description": "Call /tikhub/bilibili/huahuo/region_drop first, then put selected primary-region values in this array\n\nAPI references: `region_drop` = `GET /tikhub/bilibili/huahuo/region_drop` (operationId: `get_tikhub_bilibili_huahuo_region_drop`).", "items": { "anyOf": [ { "type": "integer" }, { "type": "string" } ] }, "type": [ "array", "null" ] }, "second_region_id": { "title": "Second Region Id", "description": "Call /tikhub/bilibili/huahuo/region_drop first, then put selected child-region values in this array\n\nAPI references: `region_drop` = `GET /tikhub/bilibili/huahuo/region_drop` (operationId: `get_tikhub_bilibili_huahuo_region_drop`).", "items": { "anyOf": [ { "type": "integer" }, { "type": "string" } ] }, "type": [ "array", "null" ] }, "partition_id": { "title": "Partition Id", "description": "Primary content-category ID from /tikhub/bilibili/huahuo/partition_drop\n\nAPI references: `partition_drop` = `GET /tikhub/bilibili/huahuo/partition_drop` (operationId: `get_tikhub_bilibili_huahuo_partition_drop`).", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "string" } ], "title": "Partition Id", "description": "Primary content-category ID from /tikhub/bilibili/huahuo/partition_drop\n\nAPI references: `partition_drop` = `GET /tikhub/bilibili/huahuo/partition_drop` (operationId: `get_tikhub_bilibili_huahuo_partition_drop`)." }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "second_partition_id": { "title": "Second Partition Id", "description": "Secondary content-category IDs from /tikhub/bilibili/huahuo/partition_drop\n\nAPI references: `partition_drop` = `GET /tikhub/bilibili/huahuo/partition_drop` (operationId: `get_tikhub_bilibili_huahuo_partition_drop`).", "items": { "anyOf": [ { "type": "integer" }, { "type": "string" } ] }, "type": [ "array", "null" ] }, "mcn_ids": { "title": "Mcn Ids", "description": "MCN organization IDs from /tikhub/bilibili/huahuo/mcn_drop\n\nAPI references: `mcn_drop` = `GET /tikhub/bilibili/huahuo/mcn_drop` (operationId: `get_tikhub_bilibili_huahuo_mcn_drop`).", "items": { "anyOf": [ { "type": "integer" }, { "type": "string" } ] }, "type": [ "array", "null" ] }, "provider_id": { "title": "Provider Id", "description": "Service-provider IDs using values offered by the Huahuo filter", "items": { "anyOf": [ { "type": "integer" }, { "type": "string" } ] }, "type": [ "array", "null" ] }, "upper_types": { "title": "Upper Types", "description": "Creator type: 1 or 4=MCN-affiliated, 3=independent", "items": { "anyOf": [ { "type": "integer" }, { "type": "string" } ] }, "type": [ "array", "null" ] }, "only_contract": { "title": "Only Contract", "description": "Contract-eligible filter: 1=only eligible creators, 0=all", "type": [ "integer", "null" ] }, "is_painter_order": { "title": "Is Painter Order", "description": "Whether to require illustration-commission capability", "type": [ "boolean", "null" ] }, "fans_age_tag": { "title": "Fans Age Tag", "description": "Audience age-affinity tags from /tikhub/bilibili/huahuo/square_static_info\n\nAPI references: `square_static_info` = `GET /tikhub/bilibili/huahuo/square_static_info` (operationId: `get_tikhub_bilibili_huahuo_square_static_info`).", "items": { "type": "string" }, "type": [ "array", "null" ] }, "fans_gender_tag": { "title": "Fans Gender Tag", "description": "Audience gender-affinity tags from /tikhub/bilibili/huahuo/square_static_info\n\nAPI references: `square_static_info` = `GET /tikhub/bilibili/huahuo/square_static_info` (operationId: `get_tikhub_bilibili_huahuo_square_static_info`).", "items": { "type": "string" }, "type": [ "array", "null" ] }, "fans_region_tag": { "title": "Fans Region Tag", "description": "Audience region-affinity tags from /tikhub/bilibili/huahuo/square_static_info\n\nAPI references: `square_static_info` = `GET /tikhub/bilibili/huahuo/square_static_info` (operationId: `get_tikhub_bilibili_huahuo_square_static_info`).", "items": { "type": "string" }, "type": [ "array", "null" ] }, "fans_stick": { "title": "Fans Stick", "description": "Follower-loyalty filter: 0 means unrestricted; obtain other values from the static filter options.", "type": [ "integer", "null" ] }, "av_active": { "title": "Av Active", "description": "Recent-publishing activity switch: 1=enabled, 0=all", "type": [ "integer", "null" ] }, "av_active_tag": { "title": "Av Active Tag", "description": "Recent-publishing activity tier from av_active_tag returned by /tikhub/bilibili/huahuo/square_static_info\n\nAPI references: `square_static_info` = `GET /tikhub/bilibili/huahuo/square_static_info` (operationId: `get_tikhub_bilibili_huahuo_square_static_info`).", "type": [ "string", "null" ] }, "dmp_group_id": { "title": "Dmp Group Id", "description": "DMP custom audience-package ID from /tikhub/bilibili/huahuo/dmp_pkg_list\n\nAPI references: `dmp_pkg_list` = `GET /tikhub/bilibili/huahuo/dmp_pkg_list` (operationId: `get_tikhub_bilibili_huahuo_dmp_pkg_list`).", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "string" } ], "title": "Dmp Group Id", "description": "DMP custom audience-package ID from /tikhub/bilibili/huahuo/dmp_pkg_list\n\nAPI references: `dmp_pkg_list` = `GET /tikhub/bilibili/huahuo/dmp_pkg_list` (operationId: `get_tikhub_bilibili_huahuo_dmp_pkg_list`)." }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "category_dmp_group_id": { "title": "Category Dmp Group Id", "description": "Content-category DMP audience-package ID", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "string" } ], "title": "Category Dmp Group Id", "description": "Content-category DMP audience-package ID" }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "category_dmp_label": { "title": "Category Dmp Label", "description": "Display label for the content-category DMP audience package", "type": [ "string", "null" ] }, "dmp_pkg_name": { "title": "Dmp Pkg Name", "description": "DMP special-audience package name query", "type": [ "string", "null" ] }, "dmp_pkg_vertical_rate_gte": { "title": "Dmp Pkg Vertical Rate Gte", "description": "Minimum DMP verticality: matching videos divided by all videos", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "number" }, { "type": "string" } ], "title": "Dmp Pkg Vertical Rate Gte", "description": "Minimum DMP verticality: matching videos divided by all videos" }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "dmp_pkg_vertical_rate_lte": { "title": "Dmp Pkg Vertical Rate Lte", "description": "Maximum DMP verticality: matching videos divided by all videos", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "number" }, { "type": "string" } ], "title": "Dmp Pkg Vertical Rate Lte", "description": "Maximum DMP verticality: matching videos divided by all videos" }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "dmp_pkg_effect_rate_gte": { "title": "Dmp Pkg Effect Rate Gte", "description": "Minimum DMP influence: recent matching viewers divided by the audience population", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "number" }, { "type": "string" } ], "title": "Dmp Pkg Effect Rate Gte", "description": "Minimum DMP influence: recent matching viewers divided by the audience population" }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "dmp_pkg_effect_rate_lte": { "title": "Dmp Pkg Effect Rate Lte", "description": "Maximum DMP influence: recent matching viewers divided by the audience population", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "number" }, { "type": "string" } ], "title": "Dmp Pkg Effect Rate Lte", "description": "Maximum DMP influence: recent matching viewers divided by the audience population" }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "dmp_pkg_fan_rate_gte": { "title": "Dmp Pkg Fan Rate Gte", "description": "Minimum DMP attention: matching audience members divided by all followers", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "number" }, { "type": "string" } ], "title": "Dmp Pkg Fan Rate Gte", "description": "Minimum DMP attention: matching audience members divided by all followers" }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "dmp_pkg_fan_rate_lte": { "title": "Dmp Pkg Fan Rate Lte", "description": "Maximum DMP attention: matching audience members divided by all followers", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "number" }, { "type": "string" } ], "title": "Dmp Pkg Fan Rate Lte", "description": "Maximum DMP attention: matching audience members divided by all followers" }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "min_task_price": { "title": "Min Task Price", "description": "Minimum standard cooperation quote in RMB", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "number" }, { "type": "string" } ], "title": "Min Task Price", "description": "Minimum standard cooperation quote in RMB" }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "max_task_price": { "title": "Max Task Price", "description": "Maximum standard cooperation quote in RMB", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "number" }, { "type": "string" } ], "title": "Max Task Price", "description": "Maximum standard cooperation quote in RMB" }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "price_info": { "title": "Price Info", "description": "Cooperation-pricing filters from price_info_options returned by /tikhub/bilibili/huahuo/square_static_info; send one type per search, include all six fields, and use [] for unavailable arrays\n\nAPI references: `square_static_info` = `GET /tikhub/bilibili/huahuo/square_static_info` (operationId: `get_tikhub_bilibili_huahuo_square_static_info`).", "items": { "properties": { "cooperation_type": { "title": "Cooperation Type", "description": "Cooperation type: 1=embedded video, 2=custom video, 22=deep customization, 23=custom podcast, 24=podcast brand placement, 3=direct post, 4=repost; supported fields are returned in price_info_options.cooperation_type", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "string" } ], "title": "Cooperation Type", "description": "Cooperation type: 1=embedded video, 2=custom video, 22=deep customization, 23=custom podcast, 24=podcast brand placement, 3=direct post, 4=repost; supported fields are returned in price_info_options.cooperation_type" }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "creative_skill": { "title": "Creative Skill", "description": "Deep-customization skill IDs: 1=Overseas Filming, 2=Hardcore Tech Analysis, 3=Short Film or Mini-movie, 4=Reality Show Challenge, 5=Makeover or DIY, 6=Interview or Street Interview, 7=TVC Production, 8=Specialty Editing, 9=Other; options are returned in price_info_options.creative_skill via /tikhub/bilibili/huahuo/square_static_info\n\nAPI references: `square_static_info` = `GET /tikhub/bilibili/huahuo/square_static_info` (operationId: `get_tikhub_bilibili_huahuo_square_static_info`).", "items": { "type": "integer" }, "type": [ "array", "null" ] }, "include_content": { "title": "Include Content", "description": "Included-content IDs for custom video, deep customization, or custom podcast: 1=Authorized derivative/distribution, 2=Complimentary preview clip, 3=Custom content. Options are returned in price_info_options.include_content", "items": { "type": "integer" }, "type": [ "array", "null" ] }, "price_min": { "title": "Price Min", "description": "Minimum quote in RMB; presets are returned in price_info_options.price_range by /tikhub/bilibili/huahuo/square_static_info\n\nAPI references: `square_static_info` = `GET /tikhub/bilibili/huahuo/square_static_info` (operationId: `get_tikhub_bilibili_huahuo_square_static_info`).", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "number" }, { "type": "string" } ], "title": "Price Min", "description": "Minimum quote in RMB; presets are returned in price_info_options.price_range by /tikhub/bilibili/huahuo/square_static_info\n\nAPI references: `square_static_info` = `GET /tikhub/bilibili/huahuo/square_static_info` (operationId: `get_tikhub_bilibili_huahuo_square_static_info`)." }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "price_max": { "title": "Price Max", "description": "Maximum quote in RMB; presets are returned in price_info_options.price_range by /tikhub/bilibili/huahuo/square_static_info\n\nAPI references: `square_static_info` = `GET /tikhub/bilibili/huahuo/square_static_info` (operationId: `get_tikhub_bilibili_huahuo_square_static_info`).", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "number" }, { "type": "string" } ], "title": "Price Max", "description": "Maximum quote in RMB; presets are returned in price_info_options.price_range by /tikhub/bilibili/huahuo/square_static_info\n\nAPI references: `square_static_info` = `GET /tikhub/bilibili/huahuo/square_static_info` (operationId: `get_tikhub_bilibili_huahuo_square_static_info`)." }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "price_right": { "title": "Price Right", "description": "Cooperation-right codes, e.g. show_in_video_first_1p3, show_in_video_gte_30s, brand_over_30_percent, auth_secondary_creation, multi_cooperation_discount, give_preview, give_poster. Full list and applicable types are in price_info_options.price_right returned by /tikhub/bilibili/huahuo/square_static_info; send [] when unselected or unavailable.\n\nAPI references: `square_static_info` = `GET /tikhub/bilibili/huahuo/square_static_info` (operationId: `get_tikhub_bilibili_huahuo_square_static_info`).", "items": { "type": "string" }, "type": [ "array", "null" ] } }, "additionalProperties": true, "type": "object", "title": "UpperPriceFilter", "description": "Quote filter for a cooperation format." }, "type": [ "array", "null" ] }, "last_7_days_set_price": { "title": "Last 7 Days Set Price", "description": "Quote-updated-in-7-days filter: 1=yes, 0=all", "type": [ "integer", "null" ] }, "last_14_days_set_price": { "title": "Last 14 Days Set Price", "description": "Quote-updated-in-14-days filter: 1=yes, 0=all", "type": [ "integer", "null" ] }, "last_30_days_set_price": { "title": "Last 30 Days Set Price", "description": "Quote-updated-in-30-days filter: 1=yes, 0=all", "type": [ "integer", "null" ] }, "min_interact_rate": { "title": "Min Interact Rate", "description": "Minimum engagement rate for eligible original videos in the last 180 days", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "number" }, { "type": "string" } ], "title": "Min Interact Rate", "description": "Minimum engagement rate for eligible original videos in the last 180 days" }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "max_interact_rate": { "title": "Max Interact Rate", "description": "Maximum engagement rate for eligible original videos in the last 180 days", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "number" }, { "type": "string" } ], "title": "Max Interact Rate", "description": "Maximum engagement rate for eligible original videos in the last 180 days" }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "blue_url_ctr_gte": { "title": "Blue Url Ctr Gte", "description": "Minimum blue-link CTR, blue-link clicks divided by video views", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "number" }, { "type": "string" } ], "title": "Blue Url Ctr Gte", "description": "Minimum blue-link CTR, blue-link clicks divided by video views" }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "blue_url_ctr_lt": { "title": "Blue Url Ctr Lt", "description": "Maximum blue-link CTR, blue-link clicks divided by video views", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "number" }, { "type": "string" } ], "title": "Blue Url Ctr Lt", "description": "Maximum blue-link CTR, blue-link clicks divided by video views" }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "blue_url_click_cost_gte": { "title": "Blue Url Click Cost Gte", "description": "Minimum blue-link click cost, cooperation and promotion spend divided by clicks", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "number" }, { "type": "string" } ], "title": "Blue Url Click Cost Gte", "description": "Minimum blue-link click cost, cooperation and promotion spend divided by clicks" }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "blue_url_click_cost_lt": { "title": "Blue Url Click Cost Lt", "description": "Maximum blue-link click cost, cooperation and promotion spend divided by clicks", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "number" }, { "type": "string" } ], "title": "Blue Url Click Cost Lt", "description": "Maximum blue-link click cost, cooperation and promotion spend divided by clicks" }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "min_play_median": { "title": "Min Play Median", "description": "Minimum median views for eligible original videos published at least seven days ago", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "number" }, { "type": "string" } ], "title": "Min Play Median", "description": "Minimum median views for eligible original videos published at least seven days ago" }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "max_play_median": { "title": "Max Play Median", "description": "Maximum median views for eligible original videos published at least seven days ago", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "number" }, { "type": "string" } ], "title": "Max Play Median", "description": "Maximum median views for eligible original videos published at least seven days ago" }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "play_median_traffic_type": { "title": "Play Median Traffic Type", "description": "Median-view traffic scope: 1=all traffic, 2=organic traffic", "type": [ "integer", "null" ] }, "play_median_cycle": { "title": "Play Median Cycle", "description": "Median-view window: 1=7 days, 2=15 days, 3=30 days", "type": [ "integer", "null" ] }, "min_cpm": { "title": "Min Cpm", "description": "Minimum CPM, calculated as spend divided by views times 1,000", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "number" }, { "type": "string" } ], "title": "Min Cpm", "description": "Minimum CPM, calculated as spend divided by views times 1,000" }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "max_cpm": { "title": "Max Cpm", "description": "Maximum CPM, calculated as spend divided by views times 1,000", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "number" }, { "type": "string" } ], "title": "Max Cpm", "description": "Maximum CPM, calculated as spend divided by views times 1,000" }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "cpm_type": { "title": "Cpm Type", "description": "CPM traffic scope: 1=all traffic, 2=organic traffic", "type": [ "integer", "null" ] }, "cpm_cycle": { "title": "Cpm Cycle", "description": "CPM window: 1=7 days, 2=15 days, 3=30 days", "type": [ "integer", "null" ] }, "min_cpc": { "title": "Min Cpc", "description": "Minimum CPC, calculated as spend divided by component clicks", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "number" }, { "type": "string" } ], "title": "Min Cpc", "description": "Minimum CPC, calculated as spend divided by component clicks" }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "max_cpc": { "title": "Max Cpc", "description": "Maximum CPC, calculated as spend divided by component clicks", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "number" }, { "type": "string" } ], "title": "Max Cpc", "description": "Maximum CPC, calculated as spend divided by component clicks" }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "cpc_traffic_type": { "title": "Cpc Traffic Type", "description": "CPC traffic scope: 1=all traffic, 2=organic traffic", "type": [ "integer", "null" ] }, "cpc_cycle": { "title": "Cpc Cycle", "description": "CPC window: 1=7 days, 2=15 days, 3=30 days", "type": [ "integer", "null" ] }, "cpe_gte": { "title": "Cpe Gte", "description": "Minimum CPE, calculated as spend divided by valid engagements", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "number" }, { "type": "string" } ], "title": "Cpe Gte", "description": "Minimum CPE, calculated as spend divided by valid engagements" }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "cpe_lt": { "title": "Cpe Lt", "description": "Maximum CPE, calculated as spend divided by valid engagements", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "number" }, { "type": "string" } ], "title": "Cpe Lt", "description": "Maximum CPE, calculated as spend divided by valid engagements" }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "cpe_traffic_type": { "title": "Cpe Traffic Type", "description": "CPE traffic scope: 1=all traffic, 2=organic traffic", "type": [ "integer", "null" ] }, "cpe_cycle": { "title": "Cpe Cycle", "description": "CPE window: 1=7 days, 3=30 days", "type": [ "integer", "null" ] }, "draft_duration": { "title": "Draft Duration", "description": "Dominant video duration: 1=0-30s, 2=30-60s, 3=1-3min, 4=3-5min, 5=5-10min, 6=over 10min", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "string" } ], "title": "Draft Duration", "description": "Dominant video duration: 1=0-30s, 2=30-60s, 3=1-3min, 4=3-5min, 5=5-10min, 6=over 10min" }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "min_avid_cnt": { "title": "Min Avid Cnt", "description": "Minimum eligible original-video count in the last 90 days", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "string" } ], "title": "Min Avid Cnt", "description": "Minimum eligible original-video count in the last 90 days" }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "max_avid_cnt": { "title": "Max Avid Cnt", "description": "Maximum eligible original-video count in the last 90 days", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "string" } ], "title": "Max Avid Cnt", "description": "Maximum eligible original-video count in the last 90 days" }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "min_hot_avid_rate": { "title": "Min Hot Avid Rate", "description": "Minimum viral-video ratio in the last 90 days", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "number" }, { "type": "string" } ], "title": "Min Hot Avid Rate", "description": "Minimum viral-video ratio in the last 90 days" }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "max_hot_avid_rate": { "title": "Max Hot Avid Rate", "description": "Maximum viral-video ratio in the last 90 days", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "number" }, { "type": "string" } ], "title": "Max Hot Avid Rate", "description": "Maximum viral-video ratio in the last 90 days" }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "half_min_hot_avid_cnt": { "title": "Half Min Hot Avid Cnt", "description": "Minimum viral-video count in the last six months", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "string" } ], "title": "Half Min Hot Avid Cnt", "description": "Minimum viral-video count in the last six months" }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "half_max_hot_avid_cnt": { "title": "Half Max Hot Avid Cnt", "description": "Maximum viral-video count in the last six months", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "string" } ], "title": "Half Max Hot Avid Cnt", "description": "Maximum viral-video count in the last six months" }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "entry_cost_min": { "title": "Entry Cost Min", "description": "Minimum store-entry cost for relevant cooperation in the last year", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "number" }, { "type": "string" } ], "title": "Entry Cost Min", "description": "Minimum store-entry cost for relevant cooperation in the last year" }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "entry_cost_max": { "title": "Entry Cost Max", "description": "Maximum store-entry cost for relevant cooperation in the last year", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "number" }, { "type": "string" } ], "title": "Entry Cost Max", "description": "Maximum store-entry cost for relevant cooperation in the last year" }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "av_honor": { "description": "Video honors have no separate options endpoint; use the search_upper documentation and always send honor_type as an array\n\nAPI references: `search_upper` = `POST /tikhub/bilibili/huahuo/search_upper` (operationId: `post_tikhub_bilibili_huahuo_search_upper`).", "anyOf": [ { "description": "Video honors have no separate options endpoint; use the search_upper documentation and always send honor_type as an array\n\nAPI references: `search_upper` = `POST /tikhub/bilibili/huahuo/search_upper` (operationId: `post_tikhub_bilibili_huahuo_search_upper`).", "allOf": [ { "properties": { "honor_type": { "title": "Honor Type", "description": "Multi-select honor types: HOT, MZBK, and QZPHB", "items": { "type": "string" }, "type": [ "array", "null" ] }, "time_period": { "title": "Time Period", "description": "Time period: 0=all, or the most recent 30, 90, or 180 days", "type": [ "integer", "null" ] }, "honor_count": { "title": "Honor Count", "description": "Honor count: 0=all, 1=once, 2=twice, 3=three or more", "type": [ "integer", "null" ] } }, "additionalProperties": true, "type": "object", "title": "UpperHonorFilter", "description": "Creator video-honor filter." } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "cooperate_experience_industry_ids": { "title": "Cooperate Experience Industry Ids", "description": "For non-general panels, call /tikhub/bilibili/huahuo/cooperate_experience_industry first and put selected IDs here; unused by the general panel\n\nAPI references: `cooperate_experience_industry` = `GET /tikhub/bilibili/huahuo/cooperate_experience_industry` (operationId: `get_tikhub_bilibili_huahuo_cooperate_experience_industry`).", "items": { "anyOf": [ { "type": "integer" }, { "type": "string" } ] }, "type": [ "array", "null" ] }, "cooperate_experience_type": { "title": "Cooperate Experience Type", "description": "Experience type for non-general strategy panels: 1=experienced, 2=extensive, 3=none in current industry, 4=experience in other industries; use 1 or 2 with selected industries, while the general panel uses spark_tag", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "string" } ], "title": "Cooperate Experience Type", "description": "Experience type for non-general strategy panels: 1=experienced, 2=extensive, 3=none in current industry, 4=experience in other industries; use 1 or 2 with selected industries, while the general panel uses spark_tag" }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "special_tags": { "title": "Special Tags", "description": "Feature-tag values from /tikhub/bilibili/huahuo/square_static_info\n\nAPI references: `square_static_info` = `GET /tikhub/bilibili/huahuo/square_static_info` (operationId: `get_tikhub_bilibili_huahuo_square_static_info`).", "items": { "type": "string" }, "type": [ "array", "null" ] }, "spark_tag": { "title": "Spark Tag", "description": "Huahuo capability tags, such as cooperate, grow, or hot_frequent. On the general panel, use cooperate for prior cooperation or coo_frequent for frequent cooperation, together with industry-tree values from /tikhub/bilibili/huahuo/square_static_info.\n\nAPI references: `square_static_info` = `GET /tikhub/bilibili/huahuo/square_static_info` (operationId: `get_tikhub_bilibili_huahuo_square_static_info`).", "items": { "type": "string" }, "type": [ "array", "null" ] }, "square_tag_in": { "title": "Square Tag In", "description": "Marketplace scenario tags, such as ad_partner_experienced.", "items": { "type": "string" }, "type": [ "array", "null" ] }, "label_array": { "title": "Label Array", "description": "Call /tikhub/bilibili/huahuo/upper_label_tree first, then put all selected content-type values in one inner array\n\nAPI references: `upper_label_tree` = `GET /tikhub/bilibili/huahuo/upper_label_tree` (operationId: `get_tikhub_bilibili_huahuo_upper_label_tree`).", "items": { "items": { "anyOf": [ { "type": "integer" }, { "type": "string" } ] }, "type": "array" }, "type": [ "array", "null" ] }, "bdata_tag_lv5": { "title": "Bdata Tag Lv5", "description": "Bilibili level-five content-tag filter values", "items": {}, "type": [ "array", "null" ] }, "huahuo_first_industry_ids": { "title": "Huahuo First Industry Ids", "description": "For the general panel, call /tikhub/bilibili/huahuo/square_static_info and put selected primary industry_tree IDs here\n\nAPI references: `square_static_info` = `GET /tikhub/bilibili/huahuo/square_static_info` (operationId: `get_tikhub_bilibili_huahuo_square_static_info`).", "items": { "anyOf": [ { "type": "integer" }, { "type": "string" } ] }, "type": [ "array", "null" ] }, "huahuo_second_industry_ids": { "title": "Huahuo Second Industry Ids", "description": "For the general panel, call /tikhub/bilibili/huahuo/square_static_info and put selected secondary industry_tree IDs here\n\nAPI references: `square_static_info` = `GET /tikhub/bilibili/huahuo/square_static_info` (operationId: `get_tikhub_bilibili_huahuo_square_static_info`).", "items": { "anyOf": [ { "type": "integer" }, { "type": "string" } ] }, "type": [ "array", "null" ] }, "huahuo_third_industry_ids": { "title": "Huahuo Third Industry Ids", "description": "For the general panel, call /tikhub/bilibili/huahuo/square_static_info and put selected tertiary industry_tree IDs here\n\nAPI references: `square_static_info` = `GET /tikhub/bilibili/huahuo/square_static_info` (operationId: `get_tikhub_bilibili_huahuo_square_static_info`).", "items": { "anyOf": [ { "type": "integer" }, { "type": "string" } ] }, "type": [ "array", "null" ] }, "goods_permission": { "title": "Goods Permission", "description": "Commerce permission filter: 1=required, 0=all", "type": [ "integer", "null" ] }, "goods_up_levels": { "title": "Goods Up Levels", "description": "Commerce-creator level values", "items": { "anyOf": [ { "type": "integer" }, { "type": "string" } ] }, "type": [ "array", "null" ] }, "goods_category_first_ids": { "title": "Goods Category First Ids", "description": "Primary commerce-category IDs from /tikhub/bilibili/huahuo/effect_goods_drop\n\nAPI references: `effect_goods_drop` = `GET /tikhub/bilibili/huahuo/effect_goods_drop` (operationId: `get_tikhub_bilibili_huahuo_effect_goods_drop`).", "items": { "anyOf": [ { "type": "integer" }, { "type": "string" } ] }, "type": [ "array", "null" ] }, "goods_category_second_ids": { "title": "Goods Category Second Ids", "description": "Secondary commerce-category IDs from /tikhub/bilibili/huahuo/effect_goods_drop\n\nAPI references: `effect_goods_drop` = `GET /tikhub/bilibili/huahuo/effect_goods_drop` (operationId: `get_tikhub_bilibili_huahuo_effect_goods_drop`).", "items": { "anyOf": [ { "type": "integer" }, { "type": "string" } ] }, "type": [ "array", "null" ] }, "goods_gpm_min": { "title": "Goods Gpm Min", "description": "Minimum 30-day GPM, paid GMV per 1,000 commerce-video views", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "number" }, { "type": "string" } ], "title": "Goods Gpm Min", "description": "Minimum 30-day GPM, paid GMV per 1,000 commerce-video views" }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "goods_gpm_max": { "title": "Goods Gpm Max", "description": "Maximum 30-day GPM, paid GMV per 1,000 commerce-video views", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "number" }, { "type": "string" } ], "title": "Goods Gpm Max", "description": "Maximum 30-day GPM, paid GMV per 1,000 commerce-video views" }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "goods_ctr_min": { "title": "Goods Ctr Min", "description": "Minimum commerce-component CTR, clicks divided by impressions", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "number" }, { "type": "string" } ], "title": "Goods Ctr Min", "description": "Minimum commerce-component CTR, clicks divided by impressions" }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "goods_ctr_max": { "title": "Goods Ctr Max", "description": "Maximum commerce-component CTR, clicks divided by impressions", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "number" }, { "type": "string" } ], "title": "Goods Ctr Max", "description": "Maximum commerce-component CTR, clicks divided by impressions" }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "goods_ctr_type": { "title": "Goods Ctr Type", "description": "Commerce CTR component scope: 1=all components, 2=comment component", "type": [ "integer", "null" ] }, "goods_avg_price_min": { "title": "Goods Avg Price Min", "description": "Minimum average product price in the last 30 days, in RMB", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "number" }, { "type": "string" } ], "title": "Goods Avg Price Min", "description": "Minimum average product price in the last 30 days, in RMB" }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "goods_avg_price_max": { "title": "Goods Avg Price Max", "description": "Maximum average product price in the last 30 days, in RMB", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "number" }, { "type": "string" } ], "title": "Goods Avg Price Max", "description": "Maximum average product price in the last 30 days, in RMB" }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "goods_is_high_video_play_permeate": { "title": "Goods Is High Video Play Permeate", "description": "High video-view penetration filter, top 20% by recent viewers per follower", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "string" } ], "title": "Goods Is High Video Play Permeate", "description": "High video-view penetration filter, top 20% by recent viewers per follower" }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "goods_is_high_fans_play_permeate": { "title": "Goods Is High Fans Play Permeate", "description": "High follower-view penetration filter", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "string" } ], "title": "Goods Is High Fans Play Permeate", "description": "High follower-view penetration filter" }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "is_boosting": { "title": "Is Boosting", "description": "Boosting-status filter: 1=currently boosting, 0=all", "type": [ "integer", "null" ] }, "is_treasure_up": { "title": "Is Treasure Up", "description": "Whether to select treasure creators.", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "string" } ], "title": "Is Treasure Up", "description": "Whether to select treasure creators." }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "is_timely_response": { "title": "Is Timely Response", "description": "Whether to require timely-response creators", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "string" } ], "title": "Is Timely Response", "description": "Whether to require timely-response creators" }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "is_new_enter": { "title": "Is New Enter", "description": "Whether to select newly onboarded creators.", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "string" } ], "title": "Is New Enter", "description": "Whether to select newly onboarded creators." }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "custom_video_pricing_set": { "title": "Custom Video Pricing Set", "description": "Whether custom-video pricing has been configured\n\nUsage: Require configured custom-video pricing;\n `is_x_plan_better_up`: X Plan preferred creators.", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "string" } ], "title": "Custom Video Pricing Set", "description": "Whether custom-video pricing has been configured\n\nUsage: Require configured custom-video pricing;\n `is_x_plan_better_up`: X Plan preferred creators." }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "is_x_plan_better_up": { "title": "Is X Plan Better Up", "description": "Whether to filter for X Plan preferred creators", "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "string" } ], "title": "Is X Plan Better Up", "description": "Whether to filter for X Plan preferred creators" }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "high_potential_type": { "title": "High Potential Type", "description": "High-potential type: 0=all, 1=onboarded, 2=not onboarded", "type": [ "integer", "null" ] } }, "additionalProperties": true, "type": "object", "title": "UpperSearchBody", "description": "### Search modes:\n- `nickname_or_mids`: Search by creator nickname or UID; separate multiple\n terms with commas.\n- `main_search`: Search by content keyword and include matched videos in\n the response.\n- `mids` / `upper_mid`: Match one or more creator UIDs exactly.\n\n### Filter groups:\n- **Profile and affiliation**: gender, followers, region, content category,\n MCN, service provider, and account type.\n- **Audience profile**: age, gender, region affinity, and follower loyalty.\n- **Pricing and performance**: quote, engagement rate, median views, CPM,\n CPC, CPE, and store-entry cost.\n- **Content and cooperation**: post count, viral-post ratio, video duration,\n honors, industries, and cooperation experience.\n- **Commerce**: permission, level, categories, GPM, component CTR, and\n average product price.\n- **Audience packages and labels**: DMP packages, feature tags, content-type\n trees, and high-potential tags.\n\nEvery field is optional. Send ratio fields as decimal values (for example,\n`0.05` for 5%) and monetary fields as the RMB values displayed by Huahuo.\nDynamic IDs are available from `square_static_info`, `upper_label_tree`,\nand the corresponding dropdown endpoints.\n\n# [Example]\n```json\n{\n \"nickname_or_mids\": \"2233,xiaodianshi\",\n \"marketing_target\": 1,\n \"panel_type\": 0,\n \"min_fans_num\": 100000,\n \"max_fans_num\": 1000000,\n \"min_interact_rate\": 0.03,\n \"play_median_traffic_type\": 1,\n \"play_median_cycle\": 3,\n \"price_info\": [{\n \"cooperation_type\": 1,\n \"creative_skill\": [],\n \"include_content\": [],\n \"price_min\": 1000,\n \"price_max\": 10000,\n \"price_right\": []\n }],\n \"goods_ctr_type\": 1,\n \"page\": 1\n}\n```\n\nAPI references: `square_static_info` = `GET /tikhub/bilibili/huahuo/square_static_info` (operationId: `get_tikhub_bilibili_huahuo_square_static_info`); `upper_label_tree` = `GET /tikhub/bilibili/huahuo/upper_label_tree` (operationId: `get_tikhub_bilibili_huahuo_upper_label_tree`)." }, "examples": { "content_type_single": { "summary": "Single content type", "description": "Select Outdoor Travel > Outdoor Adventure (upper_label_tree value=794).", "value": { "label_array": [ [ 794 ] ], "page": 1 } }, "content_type_multiple": { "summary": "Multiple content types", "description": "Select Outdoor Adventure (794), AI Short Film (747), and AI Funny Video (748) simultaneously; all values are in the same inner array.", "value": { "label_array": [ [ 794, 747, 748 ] ], "page": 1 } }, "cooperation_pricing_deep_custom": { "summary": "Deep-custom pricing", "description": "Over 100,000 RMB; includes licensed derivative creation/distribution, complimentary trailer, and custom content; creation skills selected: overseas filming, in-depth technical analysis, short film/micro-movie.", "value": { "price_info": [ { "cooperation_type": 22, "creative_skill": [ 1, 2, 3 ], "include_content": [ 1, 2, 3 ], "price_min": 100000, "price_max": "", "price_right": [] } ], "page": 1 } }, "cooperation_pricing_embedded_video": { "summary": "Embedded-video pricing", "description": "Embedded-video pricing 100,000 RMB or above; pass empty arrays for unavailable creative skills and included content.", "value": { "price_info": [ { "cooperation_type": 1, "creative_skill": [], "include_content": [], "price_min": 100000, "price_max": "", "price_right": [] } ], "page": 1 } }, "cooperation_pricing_custom_podcast": { "summary": "Custom-podcast pricing", "description": "Custom podcast series, starting at 100,000 CNY, including licensing for derivative content/distribution.", "value": { "price_info": [ { "cooperation_type": 23, "creative_skill": [], "include_content": [ 1 ], "price_min": 100000, "price_max": "", "price_right": [] } ], "page": 1 } }, "cooperation_pricing_direct_post": { "summary": "Direct-post pricing", "description": "Direct-post pricing 100,000 RMB or above; pass empty arrays for unavailable array fields.", "value": { "price_info": [ { "cooperation_type": 3, "creative_skill": [], "include_content": [], "price_min": 100000, "price_max": "", "price_right": [] } ], "page": 1 } }, "cooperation_experience_real_estate": { "summary": "Real-estate cooperation experience", "description": "Cooperation count set to \"Has cooperation experience\", cooperation industry set to \"Real Estate / All\".", "value": { "panel_type": 0, "spark_tag": [ "cooperate" ], "huahuo_first_industry_ids": [ "388" ], "huahuo_second_industry_ids": [ "389", "393", "399", "401", "403" ], "huahuo_third_industry_ids": [ "390", "394", "395", "396", "398", "400", "402", "404" ], "page": 1 } }, "cooperation_experience_multiple_industries": { "summary": "Extensive multi-industry experience", "description": "Cooperation count set to \"Extensive experience\", with all selected industry IDs for Real Estate, Furniture, and Bathroom Products passed hierarchically.", "value": { "panel_type": 0, "spark_tag": [ "coo_frequent" ], "huahuo_first_industry_ids": [ "388", "405" ], "huahuo_second_industry_ids": [ "389", "393", "399", "401", "403", "406", "411" ], "huahuo_third_industry_ids": [ "390", "394", "395", "396", "398", "400", "402", "404", "407", "408", "409", "410", "413" ], "page": 1 } }, "cooperation_experience_multiple_industries_experienced": { "summary": "Multiple-industry cooperation experience", "description": "Cooperation count set to \"Has cooperation experience\", with all selected industry IDs for Real Estate, Furniture, and Bathroom Products passed hierarchically.", "value": { "panel_type": 0, "spark_tag": [ "cooperate" ], "huahuo_first_industry_ids": [ "388", "405" ], "huahuo_second_industry_ids": [ "389", "393", "399", "401", "403", "406", "411" ], "huahuo_third_industry_ids": [ "390", "394", "395", "396", "398", "400", "402", "404", "407", "408", "409", "410", "413" ], "page": 1 } }, "residence_regions_multiple": { "summary": "Multiple residence regions", "description": "Select Beijing (4), Shanghai (5), Fujian (23), and within Fujian: Xiamen (51) and Fuzhou (50).", "value": { "region_id": [ 4, 5, 23 ], "second_region_id": [ 51, 50 ], "page": 1 } }, "median_views": { "summary": "Median views", "description": "300,000 to 500,000, organic traffic scope, last 15 days; pass range as a string.", "value": { "min_play_median": "300000", "max_play_median": "500000", "play_median_traffic_type": 2, "play_median_cycle": 2, "page": 1 } }, "median_views_default_scope": { "summary": "Median views from 500K to 1M", "description": "500,000 to 1,000,000, all traffic scope, last 30 days; pass range as a string.", "value": { "min_play_median": "500000", "max_play_median": "1000000", "play_median_traffic_type": 1, "play_median_cycle": 3, "page": 1 } }, "video_honors_multiple": { "summary": "Multiple video honors", "description": "Hot or site-wide chart honor awarded twice in the last 90 days.", "value": { "av_honor": { "honor_type": [ "HOT", "QZPHB" ], "time_period": 90, "honor_count": 2 }, "page": 1 } }, "video_honors_single": { "summary": "Single video honor", "description": "Hot honor awarded once in the last 30 days.", "value": { "av_honor": { "honor_type": [ "HOT" ], "time_period": 30, "honor_count": 1 }, "page": 1 } } } } } }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:0dfcbbbfff0b9007d9404552e09da2b2aba73944f2d6ac4a5634244e435f651f" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-bilibili-huahuo-search_upper" } }, "/apis/v1/tikhub/bilibili/huahuo/search_upper_suggest": { "get": { "description": "Bilibili (huahuo). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Return creator suggestions for a nickname fragment or UID, suitable for\n autocomplete fields and creator selection.\n\n### Parameters\n- `nickname_or_mids`: Required nickname fragment or creator UID.\n- `page`: One-based page number.\n- `panel_type`: Industry strategy panel, using the same values as `search_upper`.\n- `marketing_target`: Marketing objective, using the same values as `search_upper`.\n- `cpm_type` / `play_median_traffic_type`: Metric traffic scope; 1=all\n traffic and 2=organic traffic.\n- `cpm_cycle` / `play_median_cycle`: Measurement window; 1=7 days,\n 2=15 days, and 3=30 days.\n\n### Returns\n- Suggested creators and pagination information, typically including UID,\n nickname, avatar, and basic account details.\n\n### Billing\n\nAPI references: `search_upper` = `POST /tikhub/bilibili/huahuo/search_upper` (operationId: `post_tikhub_bilibili_huahuo_search_upper`).\n\n\nPublished reference price: $0.006 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_huahuo_search_upper_suggest", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Suggested creators and pagination information, typically including UID,\n nickname, avatar, and basic account details.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili search_upper_suggest", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.006, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a4ff2c873ec0" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/huahuo/search_upper_suggest", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_huahuo_search_upper_suggest", "method": "GET", "path": "/apis/v1/tikhub/bilibili/huahuo/search_upper_suggest" }, "parameters": [ { "name": "cpm_cycle", "in": "query", "required": false, "schema": { "type": "integer", "description": "CPM window: 1=7, 2=15, 3=30 days", "default": 3, "title": "Cpm Cycle" }, "description": "CPM window: 1=7, 2=15, 3=30 days" }, { "name": "cpm_type", "in": "query", "required": false, "schema": { "type": "integer", "description": "CPM traffic scope: 1=all, 2=organic", "default": 1, "title": "Cpm Type" }, "description": "CPM traffic scope: 1=all, 2=organic" }, { "name": "marketing_target", "in": "query", "required": false, "schema": { "type": "integer", "description": "Marketing objective; values match search_upper\n\nUsage: Marketing objective, using the same values as `search_upper`.\n\nAPI references: `search_upper` = `POST /tikhub/bilibili/huahuo/search_upper` (operationId: `post_tikhub_bilibili_huahuo_search_upper`).", "default": 1, "title": "Marketing Target" }, "description": "Marketing objective; values match search_upper\n\nUsage: Marketing objective, using the same values as `search_upper`.\n\nAPI references: `search_upper` = `POST /tikhub/bilibili/huahuo/search_upper` (operationId: `post_tikhub_bilibili_huahuo_search_upper`)." }, { "name": "nickname_or_mids", "in": "query", "required": true, "schema": { "type": "string", "description": "Creator nickname fragment or UID", "title": "Nickname Or Mids" }, "description": "Creator nickname fragment or UID" }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "description": "One-based page number", "default": 1, "title": "Page" }, "description": "One-based page number" }, { "name": "panel_type", "in": "query", "required": false, "schema": { "type": "integer", "description": "Industry strategy panel; values match search_upper\n\nUsage: Industry strategy panel, using the same values as `search_upper`.\n\nAPI references: `search_upper` = `POST /tikhub/bilibili/huahuo/search_upper` (operationId: `post_tikhub_bilibili_huahuo_search_upper`).", "default": 0, "title": "Panel Type" }, "description": "Industry strategy panel; values match search_upper\n\nUsage: Industry strategy panel, using the same values as `search_upper`.\n\nAPI references: `search_upper` = `POST /tikhub/bilibili/huahuo/search_upper` (operationId: `post_tikhub_bilibili_huahuo_search_upper`)." }, { "name": "play_median_cycle", "in": "query", "required": false, "schema": { "type": "integer", "description": "Median-view window: 1=7, 2=15, 3=30 days", "default": 3, "title": "Play Median Cycle" }, "description": "Median-view window: 1=7, 2=15, 3=30 days" }, { "name": "play_median_traffic_type", "in": "query", "required": false, "schema": { "type": "integer", "description": "Median-view traffic scope: 1=all, 2=organic", "default": 1, "title": "Play Median Traffic Type" }, "description": "Median-view traffic scope: 1=all, 2=organic" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e383df775fd178b7abfe8718f657d289acebd37fda28975031b129ca4b1ec939" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-huahuo-search_upper_suggest" } }, "/apis/v1/tikhub/bilibili/huahuo/square_static_info": { "get": { "description": "Bilibili (huahuo). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Retrieve the primary filter dictionaries used to build creator marketplace search forms.\n\n### Parameters\n- None.\n\n### Returns\n- `fans_age_tag`, `fans_gender_tag`, and `fans_region_tag`: Audience-profile options.\n- `gender_info`: Creator-gender options.\n- `av_active_tag`: Recent-publishing activity options.\n- Feature labels with child options and the three-level cooperation-industry\n tree at `data.industry_tree`.\n- `data.price_info_options`: Cooperation-pricing dictionaries for\n `search_upper.price_info`. `cooperation_type` includes each type's\n `supported_fields`; `price_range` supplies ready-to-use `price_min` and\n `price_max`; values from `price_right`, `include_content`, and\n `creative_skill` go into the matching arrays. Each option's\n `cooperation_types` lists the types for which it is valid.\n- For the general panel (`panel_type=0`), put the selected path's first-,\n second-, and third-level IDs into `search_upper.huahuo_first_industry_ids`,\n `huahuo_second_industry_ids`, and `huahuo_third_industry_ids`. Send\n `spark_tag=[\"cooperate\"]` for any experience or\n `spark_tag=[\"coo_frequent\"]` for extensive experience.\n- For non-general panels, use `cooperate_experience_industry` instead of\n `industry_tree`.\n\n### Example\n`GET /tikhub/bilibili/huahuo/square_static_info`\n\n### Billing\n\nAPI references: `cooperate_experience_industry` = `GET /tikhub/bilibili/huahuo/cooperate_experience_industry` (operationId: `get_tikhub_bilibili_huahuo_cooperate_experience_industry`); `search_upper` = `POST /tikhub/bilibili/huahuo/search_upper` (operationId: `post_tikhub_bilibili_huahuo_search_upper`).\n\n\nPublished reference price: $0.006 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_huahuo_square_static_info", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- `fans_age_tag`, `fans_gender_tag`, and `fans_region_tag`: Audience-profile options.\n- `gender_info`: Creator-gender options.\n- `av_active_tag`: Recent-publishing activity options.\n- Feature labels with child options and the three-level cooperation-industry\n tree at `data.industry_tree`.\n- `data.price_info_options`: Cooperation-pricing dictionaries for\n `search_upper.price_info`. `cooperation_type` includes each type's\n `supported_fields`; `price_range` supplies ready-to-use `price_min` and\n `price_max`; values from `price_right`, `include_content`, and\n `creative_skill` go into the matching arrays. Each option's\n `cooperation_types` lists the types for which it is valid.\n- For the general panel (`panel_type=0`), put the selected path's first-,\n second-, and third-level IDs into `search_upper.huahuo_first_industry_ids`,\n `huahuo_second_industry_ids`, and `huahuo_third_industry_ids`. Send\n `spark_tag=[\"cooperate\"]` for any experience or\n `spark_tag=[\"coo_frequent\"]` for extensive experience.\n- For non-general panels, use `cooperate_experience_industry` instead of\n `industry_tree`.\n\nAPI references: `cooperate_experience_industry` = `GET /tikhub/bilibili/huahuo/cooperate_experience_industry` (operationId: `get_tikhub_bilibili_huahuo_cooperate_experience_industry`); `search_upper` = `POST /tikhub/bilibili/huahuo/search_upper` (operationId: `post_tikhub_bilibili_huahuo_search_upper`).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili square_static_info", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.006, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a8cc09a87284" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/huahuo/square_static_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_huahuo_square_static_info", "method": "GET", "path": "/apis/v1/tikhub/bilibili/huahuo/square_static_info" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:90709c9c9bb2e48dcfb63057b61463fcf4d77d4eb65cc0c703dfb3f644c2dcc5" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-huahuo-square_static_info" } }, "/apis/v1/tikhub/bilibili/huahuo/tag_character": { "get": { "description": "Bilibili (huahuo). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Retrieve persona tags describing a creator's image and account positioning.\n\n### Parameters\n- None.\n\n### Returns\n- Persona tag IDs, names, and display information.\n\n### Billing\n\n\nPublished reference price: $0.006 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_huahuo_tag_character", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Persona tag IDs, names, and display information.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili tag_character", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.006, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "3f00c2f93d60" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/huahuo/tag_character", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_huahuo_tag_character", "method": "GET", "path": "/apis/v1/tikhub/bilibili/huahuo/tag_character" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:d9e72677887d03f64bc8dd8ad8428438ca6feb9b09440a8709ea7f47e338f21c" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-huahuo-tag_character" } }, "/apis/v1/tikhub/bilibili/huahuo/tag_commercial": { "get": { "description": "Bilibili (huahuo). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Retrieve tags describing creators' commercial collaboration characteristics and capabilities.\n\n### Parameters\n- None.\n\n### Returns\n- Commercial tag IDs, names, and display information.\n\n### Billing\n\n\nPublished reference price: $0.006 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_huahuo_tag_commercial", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Commercial tag IDs, names, and display information.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili tag_commercial", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.006, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "73bedbabe4f7" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/huahuo/tag_commercial", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_huahuo_tag_commercial", "method": "GET", "path": "/apis/v1/tikhub/bilibili/huahuo/tag_commercial" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:304fdcb181347362ee5c77e6c41cca166d23d7c333451918a7634df520f88c0d" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-huahuo-tag_commercial" } }, "/apis/v1/tikhub/bilibili/huahuo/tag_occupation": { "get": { "description": "Bilibili (huahuo). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Retrieve occupation tags used for creator profiling and filtering.\n\n### Parameters\n- None.\n\n### Returns\n- Occupation tag IDs, names, and display information.\n\n### Billing\n\n\nPublished reference price: $0.006 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_huahuo_tag_occupation", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Occupation tag IDs, names, and display information.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili tag_occupation", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.006, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "0f031f785442" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/huahuo/tag_occupation", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_huahuo_tag_occupation", "method": "GET", "path": "/apis/v1/tikhub/bilibili/huahuo/tag_occupation" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:ba410723eda487a70806a5f576e1bf023d9e2d7236248ec032b84727ba45b8ad" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-huahuo-tag_occupation" } }, "/apis/v1/tikhub/bilibili/huahuo/upper_archive_highlights": { "get": { "description": "Bilibili (huahuo). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Review video highlights within a selected period and identify high-potential content.\n\n### Parameters\n- `upper_mid`: Required creator UID.\n- `day_range`: Period: `1` last 30 days, `2` last 90 days, or `3` last\n 180 days. Defaults to `3`.\n\n### Returns\n- Highlight labels and aggregate statistics such as site-wide top videos,\n popular videos, and high-value videos.\n\n### Billing\n\n\nPublished reference price: $0.006 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_huahuo_upper_archive_highlights", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- Highlight labels and aggregate statistics such as site-wide top videos,\n popular videos, and high-value videos.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili upper_archive_highlights", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.006, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "d39e83c65d40" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/huahuo/upper_archive_highlights", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_huahuo_upper_archive_highlights", "method": "GET", "path": "/apis/v1/tikhub/bilibili/huahuo/upper_archive_highlights" }, "parameters": [ { "name": "day_range", "in": "query", "required": false, "schema": { "type": "integer", "description": "Time period: 1=last 30 days, 2=last 90 days, 3=last 180 days\n\nUsage: Period: `1` last 30 days, `2` last 90 days, or `3` last\n 180 days. Defaults to `3`.", "default": 3, "title": "Day Range" }, "description": "Time period: 1=last 30 days, 2=last 90 days, 3=last 180 days\n\nUsage: Period: `1` last 30 days, `2` last 90 days, or `3` last\n 180 days. Defaults to `3`." }, { "name": "upper_mid", "in": "query", "required": true, "schema": { "type": "integer", "description": "Creator UID", "title": "Upper Mid" }, "description": "Creator UID" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:36174a06ea306c880b19aac3c12eae545b7db48a76853e6bc2983496baccbfe8" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-huahuo-upper_archive_highlights" } }, "/apis/v1/tikhub/bilibili/huahuo/upper_base_info": { "get": { "description": "Bilibili (huahuo). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Retrieve a creator's basic identity and supported collaboration formats.\n\n### Parameters\n- `mid`: Required creator UID.\n\n### Returns\n- UID, nickname, avatar, MCN organization, and supported collaboration\n types in `state_types`.\n\n### Billing\n\n\nPublished reference price: $0.006 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_huahuo_upper_base_info", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- UID, nickname, avatar, MCN organization, and supported collaboration\n types in `state_types`.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili upper_base_info", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.006, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "48b43a6f89e1" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/huahuo/upper_base_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_huahuo_upper_base_info", "method": "GET", "path": "/apis/v1/tikhub/bilibili/huahuo/upper_base_info" }, "parameters": [ { "name": "mid", "in": "query", "required": true, "schema": { "type": "integer", "description": "Creator UID", "title": "Mid" }, "description": "Creator UID" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:882f2240420977df160644983455bb91b2a4855ac8298350eb46a967d1737f7c" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-huahuo-upper_base_info" } }, "/apis/v1/tikhub/bilibili/huahuo/upper_busy_time": { "get": { "description": "Bilibili (huahuo). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Check a creator's unavailable dates when planning a collaboration schedule.\n\n### Parameters\n- `mid`: Required creator UID.\n\n### Returns\n- Occupied or unavailable dates and related schedule information.\n\n### Billing\n\n\nPublished reference price: $0.006 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_huahuo_upper_busy_time", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- Occupied or unavailable dates and related schedule information.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili upper_busy_time", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.006, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "0d390d91216b" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/huahuo/upper_busy_time", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_huahuo_upper_busy_time", "method": "GET", "path": "/apis/v1/tikhub/bilibili/huahuo/upper_busy_time" }, "parameters": [ { "name": "mid", "in": "query", "required": true, "schema": { "type": "integer", "description": "Creator UID", "title": "Mid" }, "description": "Creator UID" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:02cff8ae3955f3a71972d0dc27707de261a600b11bcee1aec6c04a0c2f0cbf5b" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-huahuo-upper_busy_time" } }, "/apis/v1/tikhub/bilibili/huahuo/upper_by_nickname": { "get": { "description": "Bilibili (huahuo). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Find creators by full or partial nickname and resolve their UID and basic profile.\n\n### Parameters\n- `nickname`: Required creator nickname or nickname fragment.\n\n### Returns\n- Matching creators with UID, nickname, avatar, and basic account information.\n\n### Billing\n\n\nPublished reference price: $0.006 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_huahuo_upper_by_nickname", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Matching creators with UID, nickname, avatar, and basic account information.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili upper_by_nickname", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.006, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "6d04034bcb43" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/huahuo/upper_by_nickname", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_huahuo_upper_by_nickname", "method": "GET", "path": "/apis/v1/tikhub/bilibili/huahuo/upper_by_nickname" }, "parameters": [ { "name": "nickname", "in": "query", "required": true, "schema": { "type": "string", "description": "Required creator nickname or nickname fragment.", "title": "Nickname" }, "description": "Required creator nickname or nickname fragment." } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:7ad9401b798fa26ed79ec6a159158492d17bfd099a3197505eb91cba73ac2ae8" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-huahuo-upper_by_nickname" } }, "/apis/v1/tikhub/bilibili/huahuo/upper_detail": { "get": { "description": "Bilibili (huahuo). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Retrieve a complete commercial profile for creator evaluation, campaign\n selection, and collaboration pricing analysis.\n\n### Parameters\n- `upper_mid`: Required creator UID.\n\n### Returns\n- Basic profile, collaboration prices in `upper_prices`, overview metrics\n in `overview_v3`, and content/persona labels.\n- Video category and duration distributions, follower demographics in\n `*_distributions`, and viewer demographics in `*_distributions_audience`.\n\n### Billing\n\n\nPublished reference price: $0.006 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_huahuo_upper_detail", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Basic profile, collaboration prices in `upper_prices`, overview metrics\n in `overview_v3`, and content/persona labels.\n- Video category and duration distributions, follower demographics in\n `*_distributions`, and viewer demographics in `*_distributions_audience`.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili upper_detail", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.006, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "2650e58995d5" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/huahuo/upper_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_huahuo_upper_detail", "method": "GET", "path": "/apis/v1/tikhub/bilibili/huahuo/upper_detail" }, "parameters": [ { "name": "upper_mid", "in": "query", "required": true, "schema": { "type": "integer", "description": "Creator UID", "title": "Upper Mid" }, "description": "Creator UID" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:44e4c39a1380976ce444b576241f505916a4cc073090510e51acac6448fdc01c" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-huahuo-upper_detail" } }, "/apis/v1/tikhub/bilibili/huahuo/upper_draft_performance": { "get": { "description": "Bilibili (huahuo). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Summarize a creator's content mix and traffic performance over a selected period.\n\n### Parameters\n- `upper_mid`: Required creator UID.\n- `day_range`: Period: `1` last 30 days, `2` last 90 days, or `3` last\n 180 days. Defaults to `3`.\n\n### Returns\n- Video-category distribution, duration distribution, traffic-source\n distribution, and related aggregate metrics.\n\n### Billing\n\n\nPublished reference price: $0.006 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_huahuo_upper_draft_performance", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Video-category distribution, duration distribution, traffic-source\n distribution, and related aggregate metrics.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili upper_draft_performance", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.006, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "5fde045e21b5" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/huahuo/upper_draft_performance", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_huahuo_upper_draft_performance", "method": "GET", "path": "/apis/v1/tikhub/bilibili/huahuo/upper_draft_performance" }, "parameters": [ { "name": "day_range", "in": "query", "required": false, "schema": { "type": "integer", "description": "Time period: 1=last 30 days, 2=last 90 days, 3=last 180 days\n\nUsage: Period: `1` last 30 days, `2` last 90 days, or `3` last\n 180 days. Defaults to `3`.", "default": 3, "title": "Day Range" }, "description": "Time period: 1=last 30 days, 2=last 90 days, 3=last 180 days\n\nUsage: Period: `1` last 30 days, `2` last 90 days, or `3` last\n 180 days. Defaults to `3`." }, { "name": "upper_mid", "in": "query", "required": true, "schema": { "type": "integer", "description": "Creator UID", "title": "Upper Mid" }, "description": "Creator UID" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:edee6aae0310eb9d45406985f3445d20d6d72000290ffe8eb4f859793faca568" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-huahuo-upper_draft_performance" } }, "/apis/v1/tikhub/bilibili/huahuo/upper_draft_trend": { "get": { "description": "Bilibili (huahuo). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Analyze changes in a creator's video views, engagement, or watch-time metrics.\n\n### Parameters\n- `upper_mid`: Required creator UID.\n- `trend_type`: Metric type: `3` views, `4` likes, `5` comments,\n `6` danmaku comments, or `7` watch time. Defaults to `3`.\n\n### Returns\n- Metric trend series, median, minimum and maximum values, plus per-video details.\n\n### Billing\n\n\nPublished reference price: $0.006 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_huahuo_upper_draft_trend", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Metric trend series, median, minimum and maximum values, plus per-video details.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili upper_draft_trend", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.006, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "7a2cfd792f86" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/huahuo/upper_draft_trend", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_huahuo_upper_draft_trend", "method": "GET", "path": "/apis/v1/tikhub/bilibili/huahuo/upper_draft_trend" }, "parameters": [ { "name": "trend_type", "in": "query", "required": false, "schema": { "type": "integer", "description": "Metric: 3=Views, 4=Likes, 5=Comments, 6=Bullet comments, 7=Watch duration\n\nUsage: Metric type: `3` views, `4` likes, `5` comments,\n `6` danmaku comments, or `7` watch time. Defaults to `3`.", "default": 3, "title": "Trend Type" }, "description": "Metric: 3=Views, 4=Likes, 5=Comments, 6=Bullet comments, 7=Watch duration\n\nUsage: Metric type: `3` views, `4` likes, `5` comments,\n `6` danmaku comments, or `7` watch time. Defaults to `3`." }, { "name": "upper_mid", "in": "query", "required": true, "schema": { "type": "integer", "description": "Creator UID", "title": "Upper Mid" }, "description": "Creator UID" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:0c36d0ffb59eb45aca8e394cdce3ea8b18f0d743054d2bf66f932a6ce3363bcb" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-huahuo-upper_draft_trend" } }, "/apis/v1/tikhub/bilibili/huahuo/upper_fans_trend": { "get": { "description": "Bilibili (huahuo). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Review follower size and growth velocity to evaluate account momentum and stability.\n\n### Parameters\n- `upper_mid`: Required creator UID.\n- `query_type`: Data mode: `1` total followers or `2` follower growth.\n Defaults to `1`.\n\n### Returns\n- Daily follower trend data and growth amount/rate for the last 7, 30, 90,\n 180, and 365 days.\n\n### Billing\n\n\nPublished reference price: $0.006 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_huahuo_upper_fans_trend", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Daily follower trend data and growth amount/rate for the last 7, 30, 90,\n 180, and 365 days.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili upper_fans_trend", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.006, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "b950f8d7c4dd" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/huahuo/upper_fans_trend", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_huahuo_upper_fans_trend", "method": "GET", "path": "/apis/v1/tikhub/bilibili/huahuo/upper_fans_trend" }, "parameters": [ { "name": "query_type", "in": "query", "required": false, "schema": { "type": "integer", "description": "Metric scope: 1=Total, 2=Incremental\n\nUsage: Data mode: `1` total followers or `2` follower growth.\n Defaults to `1`.", "default": 1, "title": "Query Type" }, "description": "Metric scope: 1=Total, 2=Incremental\n\nUsage: Data mode: `1` total followers or `2` follower growth.\n Defaults to `1`." }, { "name": "upper_mid", "in": "query", "required": true, "schema": { "type": "integer", "description": "Creator UID", "title": "Upper Mid" }, "description": "Creator UID" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:30fcb6b47ff7ab8b689be68b9e67f0d465744a3ef177b8e429d8dda960129f52" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-huahuo-upper_fans_trend" } }, "/apis/v1/tikhub/bilibili/huahuo/upper_label_tree": { "get": { "description": "Bilibili (huahuo). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Retrieve the creator-filter configuration for a selected industry strategy panel.\n\n### Parameters\n- `panel_type`: Strategy panel: `0` general, `1` gaming, `2` beauty,\n `3` digital products, `4` automotive, `5` performance, `6` food and\n beverage, or `8` internet services.\n\n### Returns\n- A configuration tree containing filter groups, fields, labels, option values,\n and display order.\n- `search_upper.label_array` uses only node `value`s from the “Content type”\n group, with every selected content type in one inner array. A single Outdoor\n adventure selection is `[[794]]`; Outdoor adventure, AI short film, and AI\n entertainment together are `[[794,747,748]]`.\n- `label_array` is only for content types. Cooperation-pricing options are\n returned at `data.price_info_options` by `square_static_info`.\n\n### Example\n`GET /tikhub/bilibili/huahuo/upper_label_tree?panel_type=0`\n\n### Billing\n\nAPI references: `search_upper` = `POST /tikhub/bilibili/huahuo/search_upper` (operationId: `post_tikhub_bilibili_huahuo_search_upper`); `square_static_info` = `GET /tikhub/bilibili/huahuo/square_static_info` (operationId: `get_tikhub_bilibili_huahuo_square_static_info`).\n\n\nPublished reference price: $0.006 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_huahuo_upper_label_tree", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- A configuration tree containing filter groups, fields, labels, option values,\n and display order.\n- `search_upper.label_array` uses only node `value`s from the “Content type”\n group, with every selected content type in one inner array. A single Outdoor\n adventure selection is `[[794]]`; Outdoor adventure, AI short film, and AI\n entertainment together are `[[794,747,748]]`.\n- `label_array` is only for content types. Cooperation-pricing options are\n returned at `data.price_info_options` by `square_static_info`.\n\nAPI references: `search_upper` = `POST /tikhub/bilibili/huahuo/search_upper` (operationId: `post_tikhub_bilibili_huahuo_search_upper`); `square_static_info` = `GET /tikhub/bilibili/huahuo/square_static_info` (operationId: `get_tikhub_bilibili_huahuo_square_static_info`).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili upper_label_tree", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.006, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "6eb21250b739" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/huahuo/upper_label_tree", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_huahuo_upper_label_tree", "method": "GET", "path": "/apis/v1/tikhub/bilibili/huahuo/upper_label_tree" }, "parameters": [ { "name": "panel_type", "in": "query", "required": false, "schema": { "type": "integer", "description": "Strategy panel: 0=general, 1=gaming, 2=beauty, 3=digital, 4=automotive, 5=performance, 6=food, 8=internet\n\nUsage: Strategy panel: `0` general, `1` gaming, `2` beauty,\n `3` digital products, `4` automotive, `5` performance, `6` food and\n beverage, or `8` internet services.", "default": 0, "title": "Panel Type" }, "description": "Strategy panel: 0=general, 1=gaming, 2=beauty, 3=digital, 4=automotive, 5=performance, 6=food, 8=internet\n\nUsage: Strategy panel: `0` general, `1` gaming, `2` beauty,\n `3` digital products, `4` automotive, `5` performance, `6` food and\n beverage, or `8` internet services." } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e4e170416f47ab5de4609402bffb9067b73db284af42136249601410d836ebee" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-huahuo-upper_label_tree" } }, "/apis/v1/tikhub/bilibili/huahuo/upper_overlap_uppers": { "get": { "description": "Bilibili (huahuo). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Find creators whose audiences overlap with the target creator for\n competitor analysis and creator discovery.\n\n### Parameters\n- `upper_mid`: Required target creator UID.\n- `fans_range`: Follower-size tier, from `9` for more than two million\n followers down to `2` for 10,000–50,000 followers.\n- `page`: One-based page number.\n\n### Returns\n- Overlapping creators, audience-overlap metrics, creator profile fields,\n and pagination information.\n\n### Billing\n\n\nPublished reference price: $0.006 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_huahuo_upper_overlap_uppers", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Overlapping creators, audience-overlap metrics, creator profile fields,\n and pagination information.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili upper_overlap_uppers", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.006, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "42034e73d1c4" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/huahuo/upper_overlap_uppers", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_huahuo_upper_overlap_uppers", "method": "GET", "path": "/apis/v1/tikhub/bilibili/huahuo/upper_overlap_uppers" }, "parameters": [ { "name": "fans_range", "in": "query", "required": false, "schema": { "type": "string", "description": "Follower count tier: 9=2M+, 8=1M-2M, 7=500K-1M, 6=300K-500K, 5=200K-300K, 4=100K-200K, 3=50K-100K, 2=10K-50K\n\nUsage: Follower-size tier, from `9` for more than two million\n followers down to `2` for 10,000–50,000 followers.", "default": "6", "title": "Fans Range" }, "description": "Follower count tier: 9=2M+, 8=1M-2M, 7=500K-1M, 6=300K-500K, 5=200K-300K, 4=100K-200K, 3=50K-100K, 2=10K-50K\n\nUsage: Follower-size tier, from `9` for more than two million\n followers down to `2` for 10,000–50,000 followers." }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "default": 1, "title": "Page" }, "description": "One-based page number." }, { "name": "upper_mid", "in": "query", "required": true, "schema": { "type": "integer", "description": "Required target creator UID.", "title": "Upper Mid" }, "description": "Required target creator UID." } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:373194a21693115f4fddf0227553ed55554f875c9cee5271e08dcfd0c5c5ce09" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-huahuo-upper_overlap_uppers" } }, "/apis/v1/tikhub/bilibili/huahuo/upper_representative": { "get": { "description": "Bilibili (huahuo). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Retrieve a creator's representative personal or sponsored videos to\n assess content quality and commercial experience.\n\n### Parameters\n- `upper_mid`: Required creator UID.\n- `type`: Video type: `1` personal work or `2` commercial work. Defaults to `2`.\n\n### Returns\n- Representative videos with identifiers, titles, covers, duration, view\n counts, and highlight labels.\n\n### Billing\n\n\nPublished reference price: $0.006 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_huahuo_upper_representative", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Representative videos with identifiers, titles, covers, duration, view\n counts, and highlight labels.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili upper_representative", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.006, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "7a638e490dca" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/huahuo/upper_representative", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_huahuo_upper_representative", "method": "GET", "path": "/apis/v1/tikhub/bilibili/huahuo/upper_representative" }, "parameters": [ { "name": "type", "in": "query", "required": false, "schema": { "type": "integer", "description": "Post type: 1=personal post, 2=commercial post\n\nUsage: Video type: `1` personal work or `2` commercial work. Defaults to `2`.", "default": 2, "title": "Type" }, "description": "Post type: 1=personal post, 2=commercial post\n\nUsage: Video type: `1` personal work or `2` commercial work. Defaults to `2`." }, { "name": "upper_mid", "in": "query", "required": true, "schema": { "type": "integer", "description": "Creator UID", "title": "Upper Mid" }, "description": "Creator UID" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:ca249331f4ed7424f7de83b53e52849d21afef1fa3761bfee48e0055020becc4" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-huahuo-upper_representative" } }, "/apis/v1/tikhub/bilibili/huahuo/upper_seek_info": { "get": { "description": "Bilibili (huahuo). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Query the collaboration inquiry types and capability settings available\n for a creator.\n\n### Parameters\n- `mid`: Required creator UID.\n\n### Returns\n- Inquiry status, supported collaboration types, and related settings.\n\n### Billing\n\n\nPublished reference price: $0.006 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_huahuo_upper_seek_info", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Inquiry status, supported collaboration types, and related settings.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili upper_seek_info", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.006, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "ef31f394e76a" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/huahuo/upper_seek_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_huahuo_upper_seek_info", "method": "GET", "path": "/apis/v1/tikhub/bilibili/huahuo/upper_seek_info" }, "parameters": [ { "name": "mid", "in": "query", "required": true, "schema": { "type": "integer", "description": "Creator UID", "title": "Mid" }, "description": "Creator UID" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:363e8ba71f796e2d8f66394fe41608f8fdced50990e6620ab91bf10c398773e0" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-huahuo-upper_seek_info" } }, "/apis/v1/tikhub/bilibili/huahuo/upper_similar": { "get": { "description": "Bilibili (huahuo). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Discover creators with content similar to the target creator and expand\n a campaign's comparable-creator shortlist.\n\n### Parameters\n- `upper_mid`: Required target creator UID.\n\n### Returns\n- An array of similar creators with UID, nickname, avatar, and similarity information.\n\n### Billing\n\n\nPublished reference price: $0.006 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_huahuo_upper_similar", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- An array of similar creators with UID, nickname, avatar, and similarity information.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili upper_similar", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.006, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "bb7b35617461" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/huahuo/upper_similar", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_huahuo_upper_similar", "method": "GET", "path": "/apis/v1/tikhub/bilibili/huahuo/upper_similar" }, "parameters": [ { "name": "upper_mid", "in": "query", "required": true, "schema": { "type": "integer", "description": "Required target creator UID.", "title": "Upper Mid" }, "description": "Required target creator UID." } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:087fa6b9e2b0df5760e98b25d740be45e520ae27171af921bdc76d78af75fd6b" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-huahuo-upper_similar" } }, "/apis/v1/tikhub/bilibili/huahuo/x_huo_date_options": { "get": { "description": "Bilibili (huahuo). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get valid monthly or quarterly X-Huo periods for `popular_up_x_huo` requests.\n\n### Parameters\n- `rank_date_type`: Ranking period type: `1` monthly or `2` quarterly.\n\n### Returns\n- An ascending list of `YYYY-MM` periods. The final item is the latest\n completed period; the current incomplete period is excluded.\n\n### Billing\n\nAPI references: `popular_up_x_huo` = `GET /tikhub/bilibili/huahuo/popular_up_x_huo` (operationId: `get_tikhub_bilibili_huahuo_popular_up_x_huo`).\n\n\nPublished reference price: $0.006 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_huahuo_x_huo_date_options", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- An ascending list of `YYYY-MM` periods. The final item is the latest\n completed period; the current incomplete period is excluded.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili x_huo_date_options", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.006, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a2a527fa3559" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/huahuo/x_huo_date_options", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_huahuo_x_huo_date_options", "method": "GET", "path": "/apis/v1/tikhub/bilibili/huahuo/x_huo_date_options" }, "parameters": [ { "name": "rank_date_type", "in": "query", "required": false, "schema": { "type": "integer", "description": "Ranking period: 1=Monthly, 2=Quarterly\n\nUsage: Ranking period type: `1` monthly or `2` quarterly.", "default": 1, "title": "Rank Date Type" }, "description": "Ranking period: 1=Monthly, 2=Quarterly\n\nUsage: Ranking period type: `1` monthly or `2` quarterly." } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:9a289eaf4c921387ccb38c75c5686eaf1d6bb7cb8f77a28fa5f93435e9374bba" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-huahuo-x_huo_date_options" } }, "/apis/v1/tikhub/bilibili/huahuo/x_huo_industry_drop": { "get": { "description": "Bilibili (huahuo). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Retrieve the two-level X-Huo industry tree used by creator and product rankings.\n\n### Parameters\n- `scene`: Ranking scene: `1` creator ranking or `2` product ranking. The\n industry ID sets are different between scenes.\n\n### Returns\n- A two-level industry list whose node `id` values can be passed as\n `x_huo_industry_id` to the matching ranking endpoints.\n\n### Billing\n\n\nPublished reference price: $0.006 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_huahuo_x_huo_industry_drop", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- A two-level industry list whose node `id` values can be passed as\n `x_huo_industry_id` to the matching ranking endpoints.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili x_huo_industry_drop", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.006, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "29939a5f6d97" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/huahuo/x_huo_industry_drop", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_huahuo_x_huo_industry_drop", "method": "GET", "path": "/apis/v1/tikhub/bilibili/huahuo/x_huo_industry_drop" }, "parameters": [ { "name": "scene", "in": "query", "required": false, "schema": { "type": "integer", "description": "Scene: 1=Creator ranking, 2=Product ranking\n\nUsage: Ranking scene: `1` creator ranking or `2` product ranking. The\n industry ID sets are different between scenes.", "default": 1, "title": "Scene" }, "description": "Scene: 1=Creator ranking, 2=Product ranking\n\nUsage: Ranking scene: `1` creator ranking or `2` product ranking. The\n industry ID sets are different between scenes." } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:1d1055a014c47b96d58abea0e78bbfaed22a0c76ad1b00dad54762448e59a7a3" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-huahuo-x_huo_industry_drop" } }, "/apis/v1/tikhub/bilibili/web/bv_to_aid": { "get": { "description": "Bilibili (web).\n\n### Purpose:\n- Generate aid by bvid\n### Parameters:\n- bv_id: Video id\n### Return:\n- Video aid\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_web_bv_to_aid", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Video aid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili bv_to_aid", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "6324626d58fe" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/web/bv_to_aid", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_web_bv_to_aid", "method": "GET", "path": "/apis/v1/tikhub/bilibili/web/bv_to_aid" }, "parameters": [ { "name": "bv_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Video id", "title": "Bv Id" }, "description": "Video id", "example": "BV1M1421t7hT" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:fbfaade969a6ae4d9e7e34177656427f10c50ef409ca7aad742f003a51989ad9" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/bilibili/web/bv_to_aid?bv_id=BV1M1421t7hT' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-web-bv_to_aid" } }, "/apis/v1/tikhub/bilibili/web/fetch_all_live_areas": { "get": { "description": "Bilibili (web).\n\n### Purpose\n- Get a list of all live areas\n\n### Return\n- list of all live areas\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_web_fetch_all_live_areas", "responses": { "200": { "description": "Successful Response\n\n### Return\n- list of all live areas", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili fetch_all_live_areas", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "42b1a7b617f8" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/web/fetch_all_live_areas", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_web_fetch_all_live_areas", "method": "GET", "path": "/apis/v1/tikhub/bilibili/web/fetch_all_live_areas" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:46e35e795cb661195c980e9b1062f9608797743bf4aa2812380d664fb5a07482" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-web-fetch_all_live_areas" } }, "/apis/v1/tikhub/bilibili/web/fetch_collect_folders": { "get": { "description": "Bilibili (web).\n\n### Purpose:\n- Get user collection folders\n### Parameters:\n- uid: User UID\n### Return:\n- user collection folders\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_web_fetch_collect_folders", "responses": { "200": { "description": "Successful Response\n\n### Return\n- user collection folders", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili fetch_collect_folders", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "ce0fa4329cff" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/web/fetch_collect_folders", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_web_fetch_collect_folders", "method": "GET", "path": "/apis/v1/tikhub/bilibili/web/fetch_collect_folders" }, "parameters": [ { "name": "uid", "in": "query", "required": true, "schema": { "type": "string", "description": "User UID", "title": "Uid" }, "description": "User UID", "example": "178360345" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:5184f9245fcdae8e1a60be64e7c5bd5b470d5376c604d4fff3f81d3d835e0027" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/bilibili/web/fetch_collect_folders?uid=178360345' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-web-fetch_collect_folders" } }, "/apis/v1/tikhub/bilibili/web/fetch_com_popular": { "get": { "description": "Bilibili (web).\n\n### Purpose:\n- Get comprehensive popular video information\n### Parameters:\n- pn: Page number\n### Return:\n- comprehensive popular video information\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_web_fetch_com_popular", "responses": { "200": { "description": "Successful Response\n\n### Return\n- comprehensive popular video information", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili fetch_com_popular", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "681db2b7878c" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/web/fetch_com_popular", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_web_fetch_com_popular", "method": "GET", "path": "/apis/v1/tikhub/bilibili/web/fetch_com_popular" }, "parameters": [ { "name": "pn", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page number", "default": 1, "title": "Pn" }, "description": "Page number" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:bb3845c060a316cc4800ee626a02e0285389dd4e0d4d1201ca93c3e45723c7e7" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-web-fetch_com_popular" } }, "/apis/v1/tikhub/bilibili/web/fetch_comment_reply": { "get": { "description": "Bilibili (web).\n\n### Purpose:\n- Get reply to the specified comment\n### Parameters:\n- bv_id: Video id\n- pn: Page number\n- rpid: Reply id\n### Return:\n- Reply of the specified comment\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_web_fetch_comment_reply", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Reply of the specified comment", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili fetch_comment_reply", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "3655ee16f86d" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/web/fetch_comment_reply", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_web_fetch_comment_reply", "method": "GET", "path": "/apis/v1/tikhub/bilibili/web/fetch_comment_reply" }, "parameters": [ { "name": "bv_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Video id", "title": "Bv Id" }, "description": "Video id", "example": "BV1M1421t7hT" }, { "name": "pn", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page number", "default": 1, "title": "Pn" }, "description": "Page number" }, { "name": "rpid", "in": "query", "required": true, "schema": { "type": "string", "description": "Reply id", "title": "Rpid" }, "description": "Reply id", "example": "237109455120" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:8f4aedc45b32f30bafee09212ee9380a5809cf476ec5ed3df99f9e40ee460520" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/bilibili/web/fetch_comment_reply?bv_id=BV1M1421t7hT&rpid=237109455120' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-web-fetch_comment_reply" } }, "/apis/v1/tikhub/bilibili/web/fetch_dynamic_detail_v2": { "get": { "description": "Bilibili (web).\n\n### Purpose:\n- Get detail information of specified dynamic (v2 API)\n- Use this endpoint for video dynamics (DYNAMIC_TYPE_AV)\n- module_stat only contains comment / forward / like; for favorite / coin on image / text / article dynamics use the v1 endpoint\n### Parameters:\n- dynamic_id: Dynamic id\n### Return:\n- Dynamic detail data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_web_fetch_dynamic_detail_v2", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Dynamic detail data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili fetch_dynamic_detail", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "9c1229a9dea7" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/web/fetch_dynamic_detail_v2", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_web_fetch_dynamic_detail_v2", "method": "GET", "path": "/apis/v1/tikhub/bilibili/web/fetch_dynamic_detail_v2" }, "parameters": [ { "name": "dynamic_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Dynamic id", "title": "Dynamic Id" }, "description": "Dynamic id", "example": "1172584638000922630" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:7edab16e40d5da72ae8b5a94bb0c715a94672d9ab86adeda36b3efed2012d97b" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/bilibili/web/fetch_dynamic_detail_v2?dynamic_id=1172584638000922630' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-web-fetch_dynamic_detail_v2" } }, "/apis/v1/tikhub/bilibili/web/fetch_general_search": { "get": { "description": "Bilibili (web).\n\n### Purpose:\n- Get general search data\n### Parameters:\n- keyword: Search keyword\n- order: Order method\n - totalrank Comprehensive sorting\n - click Most played\n - pubdate Latest release\n - dm Most barrage\n - stow Most collection\n- page: Page number\n- page_size: Number per page\n- duration: Duration filter\n - 0 All durations\n - 1 Under 10 minutes\n - 2 10-30 minutes\n - 3 30-60 minutes\n - 4 Over 60 minutes\n- pubtime_begin_s: Start date, 10-digit timestamp, must be less than end date\n- pubtime_end_s: End date, 10-digit timestamp, must be greater than start date\n### Return:\n- General search data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_web_fetch_general_search", "responses": { "200": { "description": "Successful Response\n\n### Return\n- General search data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili fetch_general_search", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "da8e2e1b2fb8" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/web/fetch_general_search", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_web_fetch_general_search", "method": "GET", "path": "/apis/v1/tikhub/bilibili/web/fetch_general_search" }, "parameters": [ { "name": "duration", "in": "query", "required": false, "schema": { "type": "integer", "description": "Duration filter\n - 0 All durations\n - 1 Under 10 minutes\n - 2 10-30 minutes\n - 3 30-60 minutes\n - 4 Over 60 minutes", "default": 0, "title": "Duration" }, "description": "Duration filter\n - 0 All durations\n - 1 Under 10 minutes\n - 2 10-30 minutes\n - 3 30-60 minutes\n - 4 Over 60 minutes" }, { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Search keyword", "title": "Keyword" }, "description": "Search keyword", "example": "Naruto" }, { "name": "order", "in": "query", "required": true, "schema": { "type": "string", "description": "Order method\n - totalrank Comprehensive sorting\n - click Most played\n - pubdate Latest release\n - dm Most barrage\n - stow Most collection", "title": "Order" }, "description": "Order method\n - totalrank Comprehensive sorting\n - click Most played\n - pubdate Latest release\n - dm Most barrage\n - stow Most collection", "example": "totalrank" }, { "name": "page", "in": "query", "required": true, "schema": { "type": "integer", "description": "Page number", "title": "Page" }, "description": "Page number", "example": 1 }, { "name": "page_size", "in": "query", "required": true, "schema": { "type": "integer", "description": "Number per page", "title": "Page Size" }, "description": "Number per page", "example": 42 }, { "name": "pubtime_begin_s", "in": "query", "required": false, "schema": { "type": "integer", "description": "Start date (10-digit timestamp)", "default": 0, "title": "Pubtime Begin S" }, "description": "Start date (10-digit timestamp)" }, { "name": "pubtime_end_s", "in": "query", "required": false, "schema": { "type": "integer", "description": "End date, 10-digit timestamp, must be greater than start date", "default": 0, "title": "Pubtime End S" }, "description": "End date, 10-digit timestamp, must be greater than start date" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:050013ac88ca5a7f18c23232deaab6ea3e6f50d1a57a63921f5c7fd013c8db65" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/bilibili/web/fetch_general_search?keyword=Naruto&order=totalrank&page=1&page_size=42' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-web-fetch_general_search" } }, "/apis/v1/tikhub/bilibili/web/fetch_get_user_id": { "get": { "description": "Bilibili (web).\n\n### Purpose:\n- Extract user ID\n### Parameters:\n- share_link: User share link\n### Return:\n- User ID\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_web_fetch_get_user_id", "responses": { "200": { "description": "Successful Response\n\n### Return\n- User ID", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili fetch_get_user_id", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "ccdad695c412" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/web/fetch_get_user_id", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_web_fetch_get_user_id", "method": "GET", "path": "/apis/v1/tikhub/bilibili/web/fetch_get_user_id" }, "parameters": [ { "name": "share_link", "in": "query", "required": true, "schema": { "type": "string", "description": "User share link", "title": "Share Link" }, "description": "User share link", "example": "https://b23.tv/1ZuB5NC" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:cd0e9c82369bd4d6bda93c9b87c212bf3f52f8394c8a5a8f80d7cb2141e33815" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/bilibili/web/fetch_get_user_id?share_link=https%3A%2F%2Fb23.tv%2F1ZuB5NC' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-web-fetch_get_user_id" } }, "/apis/v1/tikhub/bilibili/web/fetch_hot_search": { "get": { "description": "Bilibili (web).\n\n### Purpose:\n- Get hot search data\n### Parameters:\n- limit: Return number\n### Return:\n- Hot search data\n### Note:\n- Send `limit` explicitly as an integer no greater than 50; use 10 for the documented default result size. The query parameter is required.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_web_fetch_hot_search", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Hot search data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili fetch_hot_search", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "11a976725043" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/web/fetch_hot_search", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_web_fetch_hot_search", "method": "GET", "path": "/apis/v1/tikhub/bilibili/web/fetch_hot_search" }, "parameters": [ { "name": "limit", "in": "query", "required": true, "schema": { "description": "Number of hot-search items to return, as an integer no greater than 50. Send this required query parameter explicitly; use 10 for the documented default result size. The official OpenAPI and SDK require an argument, so the documented default does not imply that the parameter can be omitted.", "title": "Limit", "type": "integer", "maximum": 50 }, "description": "Number of hot-search items to return, as an integer no greater than 50. Send this required query parameter explicitly; use 10 for the documented default result size. The official OpenAPI and SDK require an argument, so the documented default does not imply that the parameter can be omitted.", "example": 10 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:297f0fd9504beba5613bee8480569600cdb9ab6fbd1471f7f9b3bfaa61deeaeb" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/bilibili/web/fetch_hot_search?limit=10' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-web-fetch_hot_search" } }, "/apis/v1/tikhub/bilibili/web/fetch_live_room_detail": { "get": { "description": "Bilibili (web).\n\n### Purpose:\n- Get information of specified live room\n### Parameters:\n- room_id: Live room ID\n### Return:\n- information of specified live room\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_web_fetch_live_room_detail", "responses": { "200": { "description": "Successful Response\n\n### Return\n- information of specified live room", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili fetch_live_room_detail", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "45bcf642ab03" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/web/fetch_live_room_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_web_fetch_live_room_detail", "method": "GET", "path": "/apis/v1/tikhub/bilibili/web/fetch_live_room_detail" }, "parameters": [ { "name": "room_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Live room ID", "title": "Room Id" }, "description": "Live room ID", "example": "22816111" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:8f0ea13ebeacb2263ff57a40f4eaedc18df9e2dbaedbd35cc56a1b405d313fc4" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/bilibili/web/fetch_live_room_detail?room_id=22816111' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-web-fetch_live_room_detail" } }, "/apis/v1/tikhub/bilibili/web/fetch_live_streamers": { "get": { "description": "Bilibili (web).\n\n### Purpose:\n- Get live streamers of specified live area\n### Parameters:\n- area_id: Live area ID\n- pn: Page number\n### Return:\n- live streamers of specified live area\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_web_fetch_live_streamers", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- live streamers of specified live area", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili fetch_live_streamers", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "9b7bac3bc30e" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/web/fetch_live_streamers", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_web_fetch_live_streamers", "method": "GET", "path": "/apis/v1/tikhub/bilibili/web/fetch_live_streamers" }, "parameters": [ { "name": "area_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Live area ID", "title": "Area Id" }, "description": "Live area ID", "example": "9" }, { "name": "pn", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page number", "default": 1, "title": "Pn" }, "description": "Page number" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:820cad9f7035d6ef320dfc0c1cd1ea0571464732c6ab24b6dcb34761ef1b88de" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/bilibili/web/fetch_live_streamers?area_id=9' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-web-fetch_live_streamers" } }, "/apis/v1/tikhub/bilibili/web/fetch_live_videos": { "get": { "description": "Bilibili (web).\n\n### Purpose:\n- Get live video data of specified room\n### Parameters:\n- room_id: Live room ID\n### Return:\n- live video data of specified room\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_web_fetch_live_videos", "responses": { "200": { "description": "Successful Response\n\n### Return\n- live video data of specified room", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili fetch_live_videos", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "3c9fc7cf1068" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/web/fetch_live_videos", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_web_fetch_live_videos", "method": "GET", "path": "/apis/v1/tikhub/bilibili/web/fetch_live_videos" }, "parameters": [ { "name": "room_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Live room ID", "title": "Room Id" }, "description": "Live room ID", "example": "1815229528" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:acc3c73122ec5584cb171dc7564c6891bc40288dcfd7bea00a8e1dccbdf0f83b" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/bilibili/web/fetch_live_videos?room_id=1815229528' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-web-fetch_live_videos" } }, "/apis/v1/tikhub/bilibili/web/fetch_one_video": { "get": { "description": "Bilibili (web).\n\n### Purpose:\n- Get single video data\n### Parameters:\n- bv_id: Video id\n### Return:\n- Video data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_web_fetch_one_video", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Video data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili fetch_one_video", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "aa57a4993b3d" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/web/fetch_one_video", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_web_fetch_one_video", "method": "GET", "path": "/apis/v1/tikhub/bilibili/web/fetch_one_video" }, "parameters": [ { "name": "bv_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Video id", "title": "Bv Id" }, "description": "Video id", "example": "BV1M1421t7hT" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:c04402c8a55acbd00de016a0fdd4bf0fce4aacc24a7df0b6cab25ecd943773ec" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/bilibili/web/fetch_one_video?bv_id=BV1M1421t7hT' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-web-fetch_one_video" } }, "/apis/v1/tikhub/bilibili/web/fetch_user_collection_videos": { "get": { "description": "Bilibili (web).\n\n### Purpose:\n- Gets video data from a collection folder\n### Parameters:\n- folder_id: collection folder id\n- pn: Page number\n### Return:\n- video data from collection folder\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_web_fetch_user_collection_videos", "responses": { "200": { "description": "Successful Response\n\n### Return\n- video data from collection folder", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili fetch_user_collection_videos", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "4e0077fb578a" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/web/fetch_user_collection_videos", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_web_fetch_user_collection_videos", "method": "GET", "path": "/apis/v1/tikhub/bilibili/web/fetch_user_collection_videos" }, "parameters": [ { "name": "folder_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Collection folder id", "title": "Folder Id" }, "description": "Collection folder id", "example": "1756059545" }, { "name": "pn", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page number", "default": 1, "title": "Pn" }, "description": "Page number" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:437e0fb53c53204eb575eadd4a7847dc1cc04013e10b3567c2cdf04ff7d44ce7" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/bilibili/web/fetch_user_collection_videos?folder_id=1756059545' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-web-fetch_user_collection_videos" } }, "/apis/v1/tikhub/bilibili/web/fetch_user_dynamic": { "get": { "description": "Bilibili (web).\n\n### Purpose:\n- Get dynamic information of specified user\n### Parameters:\n- uid: User UID\n- offset: offset\n### Return:\n- dynamic information of specified user\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_web_fetch_user_dynamic", "responses": { "200": { "description": "Successful Response\n\n### Return\n- dynamic information of specified user", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili fetch_user_dynamic", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "63963a234baf" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/web/fetch_user_dynamic", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_web_fetch_user_dynamic", "method": "GET", "path": "/apis/v1/tikhub/bilibili/web/fetch_user_dynamic" }, "parameters": [ { "name": "offset", "in": "query", "required": false, "schema": { "type": "string", "description": "Start index / offset", "default": "", "title": "Offset" }, "description": "Start index / offset", "example": "953154282154098691" }, { "name": "uid", "in": "query", "required": true, "schema": { "type": "string", "description": "User UID", "title": "Uid" }, "description": "User UID", "example": "16015678" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:f321c107984981918f734f70ec4b20542e35d6ac2d8ed401a4bc9e6d3617a97a" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/bilibili/web/fetch_user_dynamic?offset=953154282154098691&uid=16015678' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-web-fetch_user_dynamic" } }, "/apis/v1/tikhub/bilibili/web/fetch_user_post_videos_v2": { "get": { "description": "Bilibili (web).\n\n### Purpose\n- Get user post video data, optionally searching by keyword within that user's works.\n- See \"Differences from V1\" below for how this compares to the upstream V1 endpoint, which is not exposed in this specification.\n\n### Parameters\n- uid: User UID\n- pn: Page number, no cap; past the last page `data.archives` comes back empty\n- ps: Page size, 1~100\n- keyword: Keyword, empty returns all works of the user\n - Single word only; do not include spaces.\n\n### Differences from V1\n- **No pagination cap**: V1 reaches at most 5000 works; this endpoint pages all the way back to the user's earliest upload. Use this one when a user has more than 5000 works.\n- **Keyword works**: this endpoint supports searching within the user's works; V1 does not.\n- **Leaner fields**: returns `aid`/`bvid`/`title`/`pubdate`/`pic`/`duration`/`desc`/`stat.view` and similar; no comment count or category fields. Use V1 for those, or fill them in per `bvid` via `/tikhub/bilibili/web/fetch_one_video`.\n- Ordering is fixed to newest-first by publish time; no `order` parameter.\n\n### Return\n- User posted video data; the list is in `data.archives`, the total in `data.page.total`\n\nAPI references: `fetch_one_video` = `GET /tikhub/bilibili/web/fetch_one_video` (operationId: `get_tikhub_bilibili_web_fetch_one_video`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_web_fetch_user_post_videos_v2", "responses": { "200": { "description": "Successful Response\n\n### Return\n- User posted video data; the list is in `data.archives`, the total in `data.page.total`", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili fetch_user_post_videos", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "bed70016660f" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/web/fetch_user_post_videos_v2", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_web_fetch_user_post_videos_v2", "method": "GET", "path": "/apis/v1/tikhub/bilibili/web/fetch_user_post_videos_v2" }, "parameters": [ { "name": "keyword", "in": "query", "required": false, "schema": { "type": "string", "description": "Keyword; leave empty to return all\n\nUsage: Keyword, empty returns all works of the user\n - Single word only; do not include spaces.", "default": "", "title": "Keyword" }, "description": "Keyword; leave empty to return all\n\nUsage: Keyword, empty returns all works of the user\n - Single word only; do not include spaces." }, { "name": "pn", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "description": "Page number, no cap; past the last page `data.archives` comes back empty", "default": 1, "title": "Pn" }, "description": "Page number, no cap; past the last page `data.archives` comes back empty" }, { "name": "ps", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 1, "description": "Page size, max 100\n\nUsage: Page size, 1~100", "default": 30, "title": "Ps" }, "description": "Page size, max 100\n\nUsage: Page size, 1~100" }, { "name": "uid", "in": "query", "required": true, "schema": { "type": "string", "description": "User UID", "title": "Uid" }, "description": "User UID", "example": "178360345" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:2924cf7cc8411b9e21a35e03dc6a8ede09806d1e75a14dd8a85bb17bc3b2072d" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/bilibili/web/fetch_user_post_videos_v2?uid=178360345' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-web-fetch_user_post_videos_v2" } }, "/apis/v1/tikhub/bilibili/web/fetch_user_profile": { "get": { "description": "Bilibili (web).\n\n### Purpose:\n- Get information of specified user\n### Parameters:\n- uid: User UID\n### Return:\n- information of specified user\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_web_fetch_user_profile", "responses": { "200": { "description": "Successful Response\n\n### Return\n- information of specified user", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili fetch_user_profile", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "4d24a80cbe2a" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/web/fetch_user_profile", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_web_fetch_user_profile", "method": "GET", "path": "/apis/v1/tikhub/bilibili/web/fetch_user_profile" }, "parameters": [ { "name": "uid", "in": "query", "required": true, "schema": { "type": "string", "description": "User UID", "title": "Uid" }, "description": "User UID", "example": "178360345" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:5033ebd6fa84ff1d1f577fe231910656184e14683035b6dd361358d9fcf0d3fd" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/bilibili/web/fetch_user_profile?uid=178360345' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-web-fetch_user_profile" } }, "/apis/v1/tikhub/bilibili/web/fetch_user_relation_stat": { "get": { "description": "Bilibili (web).\n\n### Purpose:\n- Get user relation stat (following count and follower count)\n### Parameters:\n- uid: User UID\n### Return:\n- User relation stat data\n - following: Following count\n - follower: Follower count\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_web_fetch_user_relation_stat", "responses": { "200": { "description": "Successful Response\n\n### Return\n- User relation stat data\n - following: Following count\n - follower: Follower count", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili fetch_user_relation_stat", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "7b5b8f1c801e" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/web/fetch_user_relation_stat", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_web_fetch_user_relation_stat", "method": "GET", "path": "/apis/v1/tikhub/bilibili/web/fetch_user_relation_stat" }, "parameters": [ { "name": "uid", "in": "query", "required": true, "schema": { "type": "string", "description": "User UID", "title": "Uid" }, "description": "User UID", "example": "178360345" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:fe9f28f1c3bb6ae0482f87399b7d8b72717c61a088877dec93ccafea25d5b027" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/bilibili/web/fetch_user_relation_stat?uid=178360345' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-web-fetch_user_relation_stat" } }, "/apis/v1/tikhub/bilibili/web/fetch_user_up_stat": { "get": { "description": "Bilibili (web).\n\n### Purpose:\n- Get UP stat (total video views and total likes)\n### Parameters:\n- uid: User UID\n### Return:\n- UP stat data\n - archive.view: Total video views\n - likes: Total likes\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_web_fetch_user_up_stat", "responses": { "200": { "description": "Successful Response\n\n### Return\n- UP stat data\n - archive.view: Total video views\n - likes: Total likes", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili fetch_user_up_stat", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "d8b73be5e97f" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/web/fetch_user_up_stat", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_web_fetch_user_up_stat", "method": "GET", "path": "/apis/v1/tikhub/bilibili/web/fetch_user_up_stat" }, "parameters": [ { "name": "uid", "in": "query", "required": true, "schema": { "type": "string", "description": "User UID", "title": "Uid" }, "description": "User UID", "example": "178360345" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:9c00e8db58416bf1339e349a1296f57e766d9f84502be4f5c7a7304bcd2d30df" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/bilibili/web/fetch_user_up_stat?uid=178360345' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-web-fetch_user_up_stat" } }, "/apis/v1/tikhub/bilibili/web/fetch_video_comments": { "get": { "description": "Bilibili (web).\n\n### Purpose:\n- Get comments on the specified video\n### Parameters:\n- bv_id: Video id\n- pn: Page number\n### Return:\n- comments of the specified video\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_web_fetch_video_comments", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- comments of the specified video", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili fetch_video_comments", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "769be980e41e" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/web/fetch_video_comments", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_web_fetch_video_comments", "method": "GET", "path": "/apis/v1/tikhub/bilibili/web/fetch_video_comments" }, "parameters": [ { "name": "bv_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Video id", "title": "Bv Id" }, "description": "Video id", "example": "BV1M1421t7hT" }, { "name": "pn", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page number", "default": 1, "title": "Pn" }, "description": "Page number" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:899880cab3bbd6d911b7b49bb38d398ce90638eff11db95c2b1e3d56f96c06c2" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/bilibili/web/fetch_video_comments?bv_id=BV1M1421t7hT' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-web-fetch_video_comments" } }, "/apis/v1/tikhub/bilibili/web/fetch_video_danmaku": { "get": { "description": "Bilibili (web).\n\n### Purpose:\n- Get Video Danmaku\n### Parameters:\n- cid: Video cid\n### Return:\n- Video Danmaku\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_web_fetch_video_danmaku", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Video Danmaku", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili fetch_video_danmaku", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "c047434ce88d" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/web/fetch_video_danmaku", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_web_fetch_video_danmaku", "method": "GET", "path": "/apis/v1/tikhub/bilibili/web/fetch_video_danmaku" }, "parameters": [ { "name": "cid", "in": "query", "required": true, "schema": { "type": "string", "description": "Video cid", "title": "Cid" }, "description": "Video cid", "example": "1639235405" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:db3f900f09ee61ddbc3b14a361cd4eee8fc68181d2e1ef50ccadbb14680388b8" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/bilibili/web/fetch_video_danmaku?cid=1639235405' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-web-fetch_video_danmaku" } }, "/apis/v1/tikhub/bilibili/web/fetch_video_detail": { "get": { "description": "Bilibili (web).\n\n### Purpose:\n- Get single video detail\n### Parameters:\n- aid: Video id\n### Return:\n- Video detail\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_web_fetch_video_detail", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Video detail", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili fetch_video_detail", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "e3784c05ce08" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/web/fetch_video_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_web_fetch_video_detail", "method": "GET", "path": "/apis/v1/tikhub/bilibili/web/fetch_video_detail" }, "parameters": [ { "name": "aid", "in": "query", "required": true, "schema": { "type": "string", "description": "Video id", "title": "Aid" }, "description": "Video id", "example": "114902186396822" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:cc752edd9c5578044925af1a708a87593f03188089812b5f5066e489df44d2ec" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/bilibili/web/fetch_video_detail?aid=114902186396822' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-web-fetch_video_detail" } }, "/apis/v1/tikhub/bilibili/web/fetch_video_parts": { "get": { "description": "Bilibili (web).\n\n### Purpose:\n- Get Video Parts By bvid\n### Parameters:\n- bv_id: Video id\n### Return:\n- Video Parts\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_web_fetch_video_parts", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Video Parts", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili fetch_video_parts", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "8912c1e7e47c" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/web/fetch_video_parts", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_web_fetch_video_parts", "method": "GET", "path": "/apis/v1/tikhub/bilibili/web/fetch_video_parts" }, "parameters": [ { "name": "bv_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Video id", "title": "Bv Id" }, "description": "Video id", "example": "BV1vf421i7hV" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:8133cb94f39b4da078a0cc5e28699f716e13ad9836e06a508c52a81edd65722d" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/bilibili/web/fetch_video_parts?bv_id=BV1vf421i7hV' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-web-fetch_video_parts" } }, "/apis/v1/tikhub/bilibili/web/fetch_video_play_info": { "get": { "description": "Bilibili (web).\n\n### Purpose:\n- Get single video play info\n### Parameters:\n- url: Video URL\n### Return:\n- Video data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_web_fetch_video_play_info", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Video data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili fetch_video_play_info", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "ecb88c8371b2" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/web/fetch_video_play_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_web_fetch_video_play_info", "method": "GET", "path": "/apis/v1/tikhub/bilibili/web/fetch_video_play_info" }, "parameters": [ { "name": "url", "in": "query", "required": true, "schema": { "type": "string", "description": "Video URL", "title": "Url" }, "description": "Video URL", "example": "https://www.bilibili.com/video/BV1S5uKzzE4r" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:77955fe0d15635857c070a6aa28493a874baf14b10f13e971e4bab6f9bc7a032" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/bilibili/web/fetch_video_play_info?url=https%3A%2F%2Fwww.bilibili.com%2Fvideo%2FBV1S5uKzzE4r' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-web-fetch_video_play_info" } }, "/apis/v1/tikhub/bilibili/web/fetch_video_playurl": { "get": { "description": "Bilibili (web).\n\n### Purpose:\n- Get video playurl\n### Parameters:\n- bv_id: Video id\n- cid: Video cid\n### Return:\n- Video playurl\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_web_fetch_video_playurl", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Video playurl", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili fetch_video_playurl", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "db89da7cee70" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/web/fetch_video_playurl", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_web_fetch_video_playurl", "method": "GET", "path": "/apis/v1/tikhub/bilibili/web/fetch_video_playurl" }, "parameters": [ { "name": "bv_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Video id", "title": "Bv Id" }, "description": "Video id", "example": "BV1y7411Q7Eq" }, { "name": "cid", "in": "query", "required": true, "schema": { "type": "string", "description": "Video cid", "title": "Cid" }, "description": "Video cid", "example": "171776208" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:466917e0a529e4292ebfef77d57d75ac7dfd2461ac64b18ed179c6c31a503347" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/bilibili/web/fetch_video_playurl?bv_id=BV1y7411Q7Eq&cid=171776208' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-web-fetch_video_playurl" } }, "/apis/v1/tikhub/bilibili/web/fetch_video_subtitle": { "get": { "description": "Bilibili (web).\n\n### Purpose:\n- Get video subtitle info\n### Parameters:\n- a_id: Video id\n- c_id: Video cid\n### Return:\n- Video subtitle info\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_bilibili_web_fetch_video_subtitle", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Video subtitle info", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili fetch_video_subtitle", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "b48a7fa431cb" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/web/fetch_video_subtitle", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_bilibili_web_fetch_video_subtitle", "method": "GET", "path": "/apis/v1/tikhub/bilibili/web/fetch_video_subtitle" }, "parameters": [ { "name": "a_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Video id", "title": "A Id" }, "description": "Video id", "example": "114006081739452" }, { "name": "c_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Video cid", "title": "C Id" }, "description": "Video cid", "example": "28400484458" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:1c084e577e832329190ab21f46720a5710ae688535bfa1a0f52e5c6c30f4e160" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/bilibili/web/fetch_video_subtitle?a_id=114006081739452&c_id=28400484458' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-bilibili-web-fetch_video_subtitle" } }, "/apis/v1/tikhub/bilibili/web/fetch_vip_video_playurl": { "post": { "description": "Bilibili (web).\n\n### Purpose:\n- Get VIP video playurl\n### Parameters:\n- bv_id: Video id\n- cid: Video cid\n- cookie: VIP User Cookie\n### Return:\n- VIP video playurl\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_bilibili_web_fetch_vip_video_playurl", "responses": { "200": { "description": "Successful Response\n\n### Return\n- VIP video playurl", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "bilibili fetch_vip_video_playurl", "tags": [ "tikhub.bilibili" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "37ad461a6343" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/bilibili/web/fetch_vip_video_playurl", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_bilibili_web_fetch_vip_video_playurl", "method": "POST", "path": "/apis/v1/tikhub/bilibili/web/fetch_vip_video_playurl" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "bv_id": { "type": "string", "title": "Bv Id", "description": "Video id", "example": "BV1y7411Q7Eq" }, "cid": { "type": "string", "title": "Cid", "description": "Video cid", "example": "171776208" }, "cookie": { "type": "string", "title": "Cookie", "description": "VIP User Cookie", "example": "your_vip_bilibili_cookie" } }, "type": "object", "required": [ "bv_id", "cid", "cookie" ], "title": "VIPVideoModel" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:44fb76f022b0043c8109330f812c176f242fdc9757aa1b861febb1d8670d93d8" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-bilibili-web-fetch_vip_video_playurl" } }, "/apis/v1/tikhub/douyin/app/v3/fetch_brand_hot_search_list": { "get": { "description": "Douyin (app/v3).\n\n### Purpose:\n- Get Douyin brand hot search category data\n### Return:\n- Hot brand search category data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_app_v3_fetch_brand_hot_search_list", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Hot brand search category data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_brand_hot_search_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "9b34b1073419" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/app/v3/fetch_brand_hot_search_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_app_v3_fetch_brand_hot_search_list", "method": "GET", "path": "/apis/v1/tikhub/douyin/app/v3/fetch_brand_hot_search_list" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:b3f34a8832f3ba993993e638e4791ba40f7433ead555920ccb4535e57900356a" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-app-v3-fetch_brand_hot_search_list" } }, "/apis/v1/tikhub/douyin/app/v3/fetch_brand_hot_search_list_detail": { "get": { "description": "Douyin (app/v3).\n\n### Purpose:\n- Get Douyin brand hot search list detail data\n### Parameters:\n- category_id: Category id\n### Return:\n- Hot brand search list detail data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_app_v3_fetch_brand_hot_search_list_detail", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Hot brand search list detail data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_brand_hot_search_list_detail", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "8160db768475" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/app/v3/fetch_brand_hot_search_list_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_app_v3_fetch_brand_hot_search_list_detail", "method": "GET", "path": "/apis/v1/tikhub/douyin/app/v3/fetch_brand_hot_search_list_detail" }, "parameters": [ { "name": "category_id", "in": "query", "required": true, "schema": { "type": "integer", "description": "Category id", "title": "Category Id" }, "description": "Category id", "example": 10 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:4ded5e15cb4638c10ca7b3fe5a6654e5a161d883c73c719b263adf921e4146c9" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/app/v3/fetch_brand_hot_search_list_detail?category_id=10' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-app-v3-fetch_brand_hot_search_list_detail" } }, "/apis/v1/tikhub/douyin/app/v3/fetch_hashtag_detail": { "get": { "description": "Douyin (app/v3).\n\n### Purpose:\n- Get details of specified hashtag\n### Parameters:\n- ch_id: Hashtag id\n### Return:\n- Hashtag details data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_app_v3_fetch_hashtag_detail", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Hashtag details data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_hashtag_detail", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "6a864780f732" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/app/v3/fetch_hashtag_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_app_v3_fetch_hashtag_detail", "method": "GET", "path": "/apis/v1/tikhub/douyin/app/v3/fetch_hashtag_detail" }, "parameters": [ { "name": "ch_id", "in": "query", "required": true, "schema": { "type": "integer", "description": "Hashtag id", "title": "Ch Id" }, "description": "Hashtag id", "example": 1575791821492238 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:4c99b4d5548155988d33deafd1c0b1b1e4ae57ef403e34fe657ea090cf652c1f" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/app/v3/fetch_hashtag_detail?ch_id=1575791821492238' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-app-v3-fetch_hashtag_detail" } }, "/apis/v1/tikhub/douyin/app/v3/fetch_hashtag_video_list": { "get": { "description": "Douyin (app/v3).\n\n### Purpose:\n- Get video list of specified hashtag\n### Parameters:\n- ch_id: Hashtag id\n- cursor: Cursor, used for paging, the first page is 0, the second page is the cursor value in the first response.\n- sort_type: 0: Comprehensive sorting 1: Most likes 2: Latest release\n- count: Number Please keep the default, otherwise there will be BUG.\n### Return:\n- Hashtag video list data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_app_v3_fetch_hashtag_video_list", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Hashtag video list data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_hashtag_video_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "8fd42a203ad6" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/app/v3/fetch_hashtag_video_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_app_v3_fetch_hashtag_video_list", "method": "GET", "path": "/apis/v1/tikhub/douyin/app/v3/fetch_hashtag_video_list" }, "parameters": [ { "name": "ch_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Hashtag id", "title": "Ch Id" }, "description": "Hashtag id", "example": "1575791821492238" }, { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number Please keep the default, otherwise there will be BUG.", "default": 10, "title": "Count" }, "description": "Number Please keep the default, otherwise there will be BUG." }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "integer", "description": "Cursor, used for paging, the first page is 0, the second page is the cursor value in the first response.", "default": 0, "title": "Cursor" }, "description": "Cursor, used for paging, the first page is 0, the second page is the cursor value in the first response." }, { "name": "sort_type", "in": "query", "required": false, "schema": { "type": "integer", "description": "Sort type\n\nUsage: 0: Comprehensive sorting 1: Most likes 2: Latest release", "default": 0, "title": "Sort Type" }, "description": "Sort type\n\nUsage: 0: Comprehensive sorting 1: Most likes 2: Latest release" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:2be5f28cf5cbc188e64d8f508310b5a12ae84a0f79ecee0e2eb14cd4cb0d4492" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/app/v3/fetch_hashtag_video_list?ch_id=1575791821492238' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-app-v3-fetch_hashtag_video_list" } }, "/apis/v1/tikhub/douyin/app/v3/fetch_hot_search_list": { "get": { "description": "Douyin (app/v3).\n\n### Purpose:\n- Get Douyin hot search list data, including:\n - Hot search list\n - Seeding list\n - Entertainment list\n - Social list\n - Challenge list\n\n### Parameters:\n- board_type:\n - 0: Hot search list (default)\n - 2: Other lists, such as seeding list, etc., need to pass in the corresponding board_sub_type parameter.\n- board_sub_type:\n - Empty string: Hot search list (default)\n - seeding: Seeding list\n - 2: Entertainment list\n - 4: Social list\n - hotspot_challenge: Challenge list\n### Return:\n- Hot search list data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_app_v3_fetch_hot_search_list", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Hot search list data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_hot_search_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "84e4bcccaa83" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/app/v3/fetch_hot_search_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_app_v3_fetch_hot_search_list", "method": "GET", "path": "/apis/v1/tikhub/douyin/app/v3/fetch_hot_search_list" }, "parameters": [ { "name": "board_sub_type", "in": "query", "required": false, "schema": { "type": "string", "description": "Board sub type\n\nUsage: - Empty string: Hot search list (default)\n - seeding: Seeding list\n - 2: Entertainment list\n - 4: Social list\n - hotspot_challenge: Challenge list", "default": "", "title": "Board Sub Type" }, "description": "Board sub type\n\nUsage: - Empty string: Hot search list (default)\n - seeding: Seeding list\n - 2: Entertainment list\n - 4: Social list\n - hotspot_challenge: Challenge list" }, { "name": "board_type", "in": "query", "required": false, "schema": { "type": "string", "description": "Board type\n\nUsage: - 0: Hot search list (default)\n - 2: Other lists, such as seeding list, etc., need to pass in the corresponding board_sub_type parameter.", "default": "0", "title": "Board Type" }, "description": "Board type\n\nUsage: - 0: Hot search list (default)\n - 2: Other lists, such as seeding list, etc., need to pass in the corresponding board_sub_type parameter." } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:b521eff87b99702e8966f4d1b9fda7f8caaa05599adaea7189bda489780b6926" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-app-v3-fetch_hot_search_list" } }, "/apis/v1/tikhub/douyin/app/v3/fetch_live_hot_search_list": { "get": { "description": "Douyin (app/v3).\n\n### Purpose:\n- Get Douyin live hot search list data\n### Return:\n- Live hot search list data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_app_v3_fetch_live_hot_search_list", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Live hot search list data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_live_hot_search_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "7ebdda82e33c" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/app/v3/fetch_live_hot_search_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_app_v3_fetch_live_hot_search_list", "method": "GET", "path": "/apis/v1/tikhub/douyin/app/v3/fetch_live_hot_search_list" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:51dabd97214585cc72ae003a955e0063e12e2f3ed585e91ce8335709ffe52d65" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-app-v3-fetch_live_hot_search_list" } }, "/apis/v1/tikhub/douyin/app/v3/fetch_multi_video": { "post": { "description": "Douyin (app/v3).\n\n### Purpose\n- Batch Get Video Information, support photo, video, etc., up to 10 videos at a time.\n\n### Parameters\n- Root JSON body: List of video ids, up to 10 video ids are supported.\n\n### Return\n- Video data\n\n### Note\n- If the interface returns empty, please use the same parameters to request the Web version interface. The specific response status code refers to:\n - JSON PATH: $.data.filter_list[0].reason\n - 8: This content is temporarily unavailable for viewing due to overseas copyright restrictions (short dramas, movie clips, etc.)\n - 8: The video does not exist or has been deleted\n - 5: This content is marked as private content and does not have public display permissions\n - 10: This content is marked as partially visible, only visible to some users chosen by the author\n - For more status codes, please submit them to our customer support for supplementation.\n\n### Request body\nSend the request body as a JSON array of strings at the root.\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_app_v3_fetch_multi_video", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Video data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_multi_video", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "c8bc6c4bce1d" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/app/v3/fetch_multi_video", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_app_v3_fetch_multi_video", "method": "POST", "path": "/apis/v1/tikhub/douyin/app/v3/fetch_multi_video" }, "requestBody": { "content": { "application/json": { "schema": { "items": { "type": "string" }, "type": "array", "title": "Aweme Ids", "description": " Send the request body as a JSON array of strings at the root." }, "example": [ "7448118827402972455", "7126745726494821640", "7448118827402972455", "7126745726494821640", "7448118827402972455", "7126745726494821640", "7448118827402972455", "7126745726494821640", "7448118827402972455", "7126745726494821640" ] } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:c04402c8a55acbd00de016a0fdd4bf0fce4aacc24a7df0b6cab25ecd943773ec" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/douyin/app/v3/fetch_multi_video \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '[\n \"7448118827402972455\",\n \"7126745726494821640\",\n \"7448118827402972455\",\n \"7126745726494821640\",\n \"7448118827402972455\",\n \"7126745726494821640\",\n \"7448118827402972455\",\n \"7126745726494821640\",\n \"7448118827402972455\",\n \"7126745726494821640\"\n]'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-app-v3-fetch_multi_video" } }, "/apis/v1/tikhub/douyin/app/v3/fetch_multi_video_high_quality_play_url": { "post": { "description": "Douyin (app/v3). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n If there are less than 50 videos, they will be charged as 50 videos.\n- Batch get the highest quality (original upload quality) play URL of videos\n- This interface will return the highest quality play URL, the original upload quality refers to the quality of the video when the user uploads it, usually the highest quality video has an uncompressed bitrate and the file header contains metadata.\n- The highest quality video link cannot be obtained directly from the Douyin APP or web version, and must be obtained through this interface.\n- This interface is very suitable for batch obtaining high-definition, watermark-free video links, suitable for scenarios that require high-quality videos, such as video editing, archiving, training models, etc.\n- Use concurrent requests to improve batch acquisition efficiency.\n- Support up to 50 video IDs.\n\n### Parameters\n- aweme_ids: Video id list, separated by commas, for example: \"123,456,789\", up to 50.\n\n### Return\n- total: Total count\n- success_count: Success count\n- failed_count: Failed count\n- videos: Video list, each video contains the following fields:\n - video_id: Video id\n - original_video_url: Highest quality (original upload quality) play URL\n - file_size: File size (bytes)\n - file_size_in_mb: File size (MB)\n - content_type: Content type\n - success: Whether successful\n - error: Error message (if failed)\n\n### Note\n- Due to the large number, the processing time may be slightly longer, please increase the waiting time.\n\n\nPublished reference price: $0.25 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_app_v3_fetch_multi_video_high_quality_play_url", "responses": { "200": { "description": "Successful Response\n\n### Return\n- total: Total count\n- success_count: Success count\n- failed_count: Failed count\n- videos: Video list, each video contains the following fields:\n - video_id: Video id\n - original_video_url: Highest quality (original upload quality) play URL\n - file_size: File size (bytes)\n - file_size_in_mb: File size (MB)\n - content_type: Content type\n - success: Whether successful\n - error: Error message (if failed)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_multi_video_high_quality_play_url", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.25, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "f3eaf6a784de" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/app/v3/fetch_multi_video_high_quality_play_url", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_app_v3_fetch_multi_video_high_quality_play_url", "method": "POST", "path": "/apis/v1/tikhub/douyin/app/v3/fetch_multi_video_high_quality_play_url" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "aweme_ids": { "type": "string", "title": "Aweme Ids", "description": "Video id list, separated by commas, for example: \"123,456,789\", up to 50.", "default": "7512756548356492544,7448118827402972455,7126745726494821640", "pattern": "^[^,]*(?:,[^,]*){0,49}$" }, "region": { "title": "Region", "description": "Optional, ISO country code (e.g. CN). Pass 'CN' for users in mainland China to get China-region CDN URLs for faster download.", "example": "CN", "type": [ "string", "null" ] } }, "type": "object", "title": "FetchMultiVideoHighQualityPlayUrlRequest" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:41b4b79149bd226fec14d7ef31f7f4367837795c50986ae78b95bdf64a7ba3a4" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-app-v3-fetch_multi_video_high_quality_play_url" } }, "/apis/v1/tikhub/douyin/app/v3/fetch_multi_video_statistics": { "get": { "description": "Douyin (app/v3). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get the statistical data of the Post according to the video ID, support multiple video ids, up to 50 videos at a time.\n- Most of the Douyin interfaces no longer return the number of plays of the Post, and can only be obtained through this interface.\n\n- List of statistics that can be obtained:\n - Like count (digg_count)\n - Download count (download_count)\n - Play count (play_count)\n - Share count (share_count)\n\n### Parameters\n- aweme_ids: Video id, supports multiple video ids, separated by commas, no more than 50, single is also possible, no need for commas.\n\n### Return\n- Post statistics data\n\n\nPublished reference price: $0.025 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_app_v3_fetch_multi_video_statistics", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Post statistics data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_multi_video_statistics", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.025, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "8236f1d60175" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/app/v3/fetch_multi_video_statistics", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_app_v3_fetch_multi_video_statistics", "method": "GET", "path": "/apis/v1/tikhub/douyin/app/v3/fetch_multi_video_statistics" }, "parameters": [ { "name": "aweme_ids", "in": "query", "required": true, "schema": { "type": "string", "description": "Video id, supports multiple video ids, separated by commas, no more than 50, single is also possible, no need for commas.", "title": "Aweme Ids" }, "description": "Video id, supports multiple video ids, separated by commas, no more than 50, single is also possible, no need for commas.", "example": "7448118827402972455,7126745726494821640" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:96a115a109b74a1d3dcb5564f78dd9d4c114d205434fcd8945b573cc91de5e5f" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/app/v3/fetch_multi_video_statistics?aweme_ids=7448118827402972455%2C7126745726494821640' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-app-v3-fetch_multi_video_statistics" } }, "/apis/v1/tikhub/douyin/app/v3/fetch_music_detail": { "get": { "description": "Douyin (app/v3).\n\n### Purpose:\n- Get details of specified music\n### Parameters:\n- music_id: Music id\n### Return:\n- Music details data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_app_v3_fetch_music_detail", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Music details data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_music_detail", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "981ee97d6362" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/app/v3/fetch_music_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_app_v3_fetch_music_detail", "method": "GET", "path": "/apis/v1/tikhub/douyin/app/v3/fetch_music_detail" }, "parameters": [ { "name": "music_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Music id", "title": "Music Id" }, "description": "Music id", "example": "7136850194742315016" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:cd1281d562437003948019513d8a4e7fcafe735e0daa9abb7be5be90e9013a60" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/app/v3/fetch_music_detail?music_id=7136850194742315016' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-app-v3-fetch_music_detail" } }, "/apis/v1/tikhub/douyin/app/v3/fetch_music_hot_search_list": { "get": { "description": "Douyin (app/v3).\n\n### Purpose:\n- Get Douyin music hot search list data\n### Parameters:\n- chart_type: Chart type, default value is 'hot', supports the following values:\n - 'hot': Hot chart\n - 'trending': Trending chart\n - 'original': Original chart\n- cursor: Cursor, default value is '0', used for paginating data retrieval. After each request, the next cursor value will be returned, and the `has_more` field indicates whether there is more data available.\n### Return:\n- Music hot search list data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_app_v3_fetch_music_hot_search_list", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Music hot search list data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_music_hot_search_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "8590ae48371e" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/app/v3/fetch_music_hot_search_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_app_v3_fetch_music_hot_search_list", "method": "GET", "path": "/apis/v1/tikhub/douyin/app/v3/fetch_music_hot_search_list" }, "parameters": [ { "name": "chart_type", "in": "query", "required": false, "schema": { "type": "string", "description": "Chart type, default value is 'hot', supports the following values:\n - 'hot': Hot chart\n - 'trending': Trending chart\n - 'original': Original chart", "default": "hot", "title": "Chart Type" }, "description": "Chart type, default value is 'hot', supports the following values:\n - 'hot': Hot chart\n - 'trending': Trending chart\n - 'original': Original chart", "example": "hot" }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "description": "Cursor, default value is '0', used for paginating data retrieval. After each request, the next cursor value will be returned, and the `has_more` field indicates whether there is more data available.", "default": "0", "title": "Cursor" }, "description": "Cursor, default value is '0', used for paginating data retrieval. After each request, the next cursor value will be returned, and the `has_more` field indicates whether there is more data available.", "example": "0" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:6973b52e87bb3122ed4a2ed970aae08d0c5616241842169474811cfb9f05edac" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-app-v3-fetch_music_hot_search_list" } }, "/apis/v1/tikhub/douyin/app/v3/fetch_music_video_list": { "get": { "description": "Douyin (app/v3).\n\n### Purpose:\n- Get video list of specified music\n### Parameters:\n- music_id: Music id\n- cursor: Cursor, used for paging, the first page is 0, the second page is the cursor value in the first response.\n- count: Number Please keep the default, otherwise there will be BUG.\n### Return:\n- Music video list data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_app_v3_fetch_music_video_list", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Music video list data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_music_video_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "d808b398248d" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/app/v3/fetch_music_video_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_app_v3_fetch_music_video_list", "method": "GET", "path": "/apis/v1/tikhub/douyin/app/v3/fetch_music_video_list" }, "parameters": [ { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number Please keep the default, otherwise there will be BUG.", "default": 10, "title": "Count" }, "description": "Number Please keep the default, otherwise there will be BUG." }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "integer", "description": "Cursor, used for paging, the first page is 0, the second page is the cursor value in the first response.", "default": 0, "title": "Cursor" }, "description": "Cursor, used for paging, the first page is 0, the second page is the cursor value in the first response." }, { "name": "music_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Music id", "title": "Music Id" }, "description": "Music id", "example": "7136850194742315016" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:96ffc1dd0e6a31d590cf4ec0a06683db7e3d737ad25e1472a462c1aa7dfb9d8b" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/app/v3/fetch_music_video_list?music_id=7136850194742315016' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-app-v3-fetch_music_video_list" } }, "/apis/v1/tikhub/douyin/app/v3/fetch_one_video": { "get": { "description": "Douyin (app/v3).\n\n### Purpose:\n- Get single video data, support photo, video, etc.\n### Parameters:\n- aweme_id: Video id\n### Return:\n- Video data\n### Note:\n- If the interface returns empty, please use the same parameters to request the Web version interface. The specific response status code refers to:\n - JSON PATH: $.data.filter_list[0].reason\n - 8: This content is temporarily unavailable for viewing due to overseas copyright restrictions (short dramas, movie clips, etc.)\n - 8: The video does not exist or has been deleted\n - 5: This content is marked as private content and does not have public display permissions\n - 10: This content is marked as partially visible, only visible to some users chosen by the author\n - For more status codes, please submit them to our customer support for supplementation.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_app_v3_fetch_one_video", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Video data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_one_video", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "ff1d5ab19626" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/app/v3/fetch_one_video", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_app_v3_fetch_one_video", "method": "GET", "path": "/apis/v1/tikhub/douyin/app/v3/fetch_one_video" }, "parameters": [ { "name": "aweme_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Video id", "title": "Aweme Id" }, "description": "Video id", "example": "7448118827402972455" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:77955fe0d15635857c070a6aa28493a874baf14b10f13e971e4bab6f9bc7a032" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/app/v3/fetch_one_video?aweme_id=7448118827402972455' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-app-v3-fetch_one_video" } }, "/apis/v1/tikhub/douyin/app/v3/fetch_one_video_by_share_url": { "get": { "description": "Douyin (app/v3).\n\n### Purpose:\n- Get single video data by sharing link\n### Parameters:\n- share_url: Share link\n### Return:\n- Video data\n### Note:\n- If the interface returns empty, please use the same parameters to request the Web version interface. The specific response status code refers to:\n - JSON PATH: $.data.filter_list[0].reason\n - 8: This content is temporarily unavailable for viewing due to overseas copyright restrictions (short dramas, movie clips, etc.)\n - 8: The video does not exist or has been deleted\n - 5: This content is marked as private content and does not have public display permissions\n - 10: This content is marked as partially visible, only visible to some users chosen by the author\n - For more status codes, please submit them to our customer support for supplementation.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_app_v3_fetch_one_video_by_share_url", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Video data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_one_video_by_share_url", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "0f8b16381a6f" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/app/v3/fetch_one_video_by_share_url", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_app_v3_fetch_one_video_by_share_url", "method": "GET", "path": "/apis/v1/tikhub/douyin/app/v3/fetch_one_video_by_share_url" }, "parameters": [ { "name": "share_url", "in": "query", "required": true, "schema": { "type": "string", "description": "Share link", "title": "Share Url" }, "description": "Share link", "example": "https://v.douyin.com/e3x2fjE/" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:77955fe0d15635857c070a6aa28493a874baf14b10f13e971e4bab6f9bc7a032" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/app/v3/fetch_one_video_by_share_url?share_url=https%3A%2F%2Fv.douyin.com%2Fe3x2fjE%2F' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-app-v3-fetch_one_video_by_share_url" } }, "/apis/v1/tikhub/douyin/app/v3/fetch_series_detail": { "get": { "description": "Douyin (app/v3).\n\n### Purpose:\n- Get series/playlet detail information\n### Parameters:\n- series_id: Series id\n### Return:\n- Series detail data\n### Note:\n- This interface returns detailed information of the series, including:\n - Series name, description, cover\n - Author information\n - Total episodes, update status\n - Play count, collection count and other statistics\n - Payment information (if any)\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_app_v3_fetch_series_detail", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Series detail data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_series_detail", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "5a0325001c21" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/app/v3/fetch_series_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_app_v3_fetch_series_detail", "method": "GET", "path": "/apis/v1/tikhub/douyin/app/v3/fetch_series_detail" }, "parameters": [ { "name": "series_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Series id", "title": "Series Id" }, "description": "Series id", "example": "7592054624643713067" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:6372a47423e1ebf6fe437f72330e3be1d495549b60d8ef010c8b81aa605bb1f0" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/app/v3/fetch_series_detail?series_id=7592054624643713067' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-app-v3-fetch_series_detail" } }, "/apis/v1/tikhub/douyin/app/v3/fetch_series_video_list": { "get": { "description": "Douyin (app/v3).\n\n### Purpose:\n- Get series/playlet video list\n### Parameters:\n- series_id: Series id\n- cursor: Cursor, used for paging, the first page is 0, the second page is usually the value of count (e.g., 15).\n### Return:\n- Series video list data\n### Note:\n- This interface returns all video list in the series\n- The aweme_list in the response contains video information of each episode\n- The has_more field indicates whether there is more data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_app_v3_fetch_series_video_list", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Series video list data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_series_video_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "72341c6db094" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/app/v3/fetch_series_video_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_app_v3_fetch_series_video_list", "method": "GET", "path": "/apis/v1/tikhub/douyin/app/v3/fetch_series_video_list" }, "parameters": [ { "name": "cursor", "in": "query", "required": false, "schema": { "type": "integer", "description": "Cursor, used for paging, the first page is 0, the second page is usually the value of count (e.g., 15).", "default": 0, "title": "Cursor" }, "description": "Cursor, used for paging, the first page is 0, the second page is usually the value of count (e.g., 15)." }, { "name": "series_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Series id", "title": "Series Id" }, "description": "Series id", "example": "7592054624643713067" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:023ee2d588d791659c58e3ab5dc0173fbaadd7d671fefb8012f3042f6f4ba9c4" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/app/v3/fetch_series_video_list?series_id=7592054624643713067' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-app-v3-fetch_series_video_list" } }, "/apis/v1/tikhub/douyin/app/v3/fetch_share_info_by_share_code": { "get": { "description": "Douyin (app/v3).\n\n### Purpose:\n- Get share info by share code, such as extracting sharer information and article ID from Douyin article share code, and then requesting a single video data interface to get the article content.\n### Parameters:\n- share_code: Share code\n### Return:\n- Share info, including sharer information and article ID, etc.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_app_v3_fetch_share_info_by_share_code", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Share info, including sharer information and article ID, etc.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_share_info_by_share_code", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "ebec9ad56419" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/app/v3/fetch_share_info_by_share_code", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_app_v3_fetch_share_info_by_share_code", "method": "GET", "path": "/apis/v1/tikhub/douyin/app/v3/fetch_share_info_by_share_code" }, "parameters": [ { "name": "share_code", "in": "query", "required": true, "schema": { "type": "string", "description": "Share code", "title": "Share Code" }, "description": "Share code", "example": "8:/ h@O.kP 05/21 【生意场上，装逼就是节省沟通成本】长按复制打开抖音，即可阅读文章 ︽︽2QnCB9aIZZ29︽︽" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:0b5e4dafce59022a3bfc60b20c443cb2367d4dad52cb59a5b6e4f6d01d3804fd" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/app/v3/fetch_share_info_by_share_code?share_code=8%3A%2F+h%40O.kP+05%2F21+%E3%80%90%E7%94%9F%E6%84%8F%E5%9C%BA%E4%B8%8A%EF%BC%8C%E8%A3%85%E9%80%BC%E5%B0%B1%E6%98%AF%E8%8A%82%E7%9C%81%E6%B2%9F%E9%80%9A%E6%88%90%E6%9C%AC%E3%80%91%E9%95%BF%E6%8C%89%E5%A4%8D%E5%88%B6%E6%89%93%E5%BC%80%E6%8A%96%E9%9F%B3%EF%BC%8C%E5%8D%B3%E5%8F%AF%E9%98%85%E8%AF%BB%E6%96%87%E7%AB%A0+%EF%B8%BD%EF%B8%BD2QnCB9aIZZ29%EF%B8%BD%EF%B8%BD' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-app-v3-fetch_share_info_by_share_code" } }, "/apis/v1/tikhub/douyin/app/v3/fetch_user_fans_list": { "get": { "description": "Douyin (app/v3).\n\n### Purpose:\n- Get user fans list\n### Parameters:\n- sec_user_id: User sec_user_id\n- max_time: Maximum timestamp, default is 0, get from the returned data later, used for paging.\n- count: Number, default is 20, it is recommended to keep it unchanged.\n### Return:\n- Fans list\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_app_v3_fetch_user_fans_list", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Fans list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_user_fans_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "9436c3f22533" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/app/v3/fetch_user_fans_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_app_v3_fetch_user_fans_list", "method": "GET", "path": "/apis/v1/tikhub/douyin/app/v3/fetch_user_fans_list" }, "parameters": [ { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number, default is 20, it is recommended to keep it unchanged.", "default": 20, "title": "Count" }, "description": "Number, default is 20, it is recommended to keep it unchanged." }, { "name": "max_time", "in": "query", "required": false, "schema": { "type": "string", "description": "Maximum timestamp, default is 0, get from the returned data later, used for paging.", "default": "0", "title": "Max Time" }, "description": "Maximum timestamp, default is 0, get from the returned data later, used for paging." }, { "name": "sec_user_id", "in": "query", "required": false, "schema": { "type": "string", "description": "User sec_user_id", "default": "MS4wLjABAAAA9y04iBlVdeMQqTJbqsQZKb-tqWqWW29jPVJqideHT70", "title": "Sec User Id" }, "description": "User sec_user_id" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e6bb3beadff0c2c949d89c2d70dbe6e8a48ef134256887ff83c8aa85f38c05b4" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-app-v3-fetch_user_fans_list" } }, "/apis/v1/tikhub/douyin/app/v3/fetch_user_like_videos": { "get": { "description": "Douyin (app/v3).\n\n### Purpose\n- Get user like video data\n\n### Parameters\n- sec_user_id: User sec_user_id\n- max_cursor: Maximum cursor, used for paging, the first page is 0, the second page is the max_cursor value in the first response.\n- counts: Maximum count number\n\n### Return\n- User video data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_app_v3_fetch_user_like_videos", "responses": { "200": { "description": "Successful Response\n\n### Return\n- User video data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_user_like_videos", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a9c874ba3984" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/app/v3/fetch_user_like_videos", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_app_v3_fetch_user_like_videos", "method": "GET", "path": "/apis/v1/tikhub/douyin/app/v3/fetch_user_like_videos" }, "parameters": [ { "name": "counts", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number per page", "default": 20, "title": "Counts" }, "description": "Number per page" }, { "name": "max_cursor", "in": "query", "required": false, "schema": { "type": "integer", "description": "Maximum cursor, used for paging, the first page is 0, the second page is the max_cursor value in the first response.", "default": 0, "title": "Max Cursor" }, "description": "Maximum cursor, used for paging, the first page is 0, the second page is the max_cursor value in the first response." }, { "name": "sec_user_id", "in": "query", "required": true, "schema": { "type": "string", "description": "User sec_user_id", "title": "Sec User Id" }, "description": "User sec_user_id", "example": "MS4wLjABAAAAW9FWcqS7RdQAWPd2AA5fL_ilmqsIFUCQ_Iym6Yh9_cUa6ZRqVLjVQSUjlHrfXY1Y" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:44bcdfb4c7a94fb10e7ebc4c065ce3fa885014430d44347355ca58219bbb9e69" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/app/v3/fetch_user_like_videos?sec_user_id=MS4wLjABAAAAW9FWcqS7RdQAWPd2AA5fL_ilmqsIFUCQ_Iym6Yh9_cUa6ZRqVLjVQSUjlHrfXY1Y' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-app-v3-fetch_user_like_videos" } }, "/apis/v1/tikhub/douyin/app/v3/fetch_user_post_videos": { "get": { "description": "Douyin (app/v3).\n\n### Purpose:\n- Get user homepage video data\n### Parameters:\n- sec_user_id: User sec_user_id\n- max_cursor: Maximum cursor, used for paging, the first page is 0, the second page is the max_cursor value in the first response.\n- count: Maximum count number, do not exceed 20, it is recommended to keep it unchanged.\n- sort_type: Sort type, optional values are as follows:\n - `0`: Latest sorting - default\n - `1`: Hottest sorting\n- channel: Douyin channel version, optional values are as follows:\n - `normal`: Normal Douyin - default\n - `lite`: Douyin Lite\n - Note: The normal Douyin may fail to show the latest videos on certain user homepages. In that case, switch to the Lite channel to get the user's latest posted videos.\n### Return:\n- User video data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_app_v3_fetch_user_post_videos", "responses": { "200": { "description": "Successful Response\n\n### Return\n- User video data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_user_post_videos", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "b6b693a45da2" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/app/v3/fetch_user_post_videos", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_app_v3_fetch_user_post_videos", "method": "GET", "path": "/apis/v1/tikhub/douyin/app/v3/fetch_user_post_videos" }, "parameters": [ { "name": "channel", "in": "query", "required": false, "schema": { "type": "string", "description": "Douyin channel: normal (standard version, default), lite (speed version)\n\nUsage: Douyin channel version, optional values are as follows:\n - `normal`: Normal Douyin - default\n - `lite`: Douyin Lite\n - Note: The normal Douyin may fail to show the latest videos on certain user homepages. In that case, switch to the Lite channel to get the user's latest posted videos.", "default": "normal", "title": "Channel" }, "description": "Douyin channel: normal (standard version, default), lite (speed version)\n\nUsage: Douyin channel version, optional values are as follows:\n - `normal`: Normal Douyin - default\n - `lite`: Douyin Lite\n - Note: The normal Douyin may fail to show the latest videos on certain user homepages. In that case, switch to the Lite channel to get the user's latest posted videos." }, { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number per page\n\nUsage: Maximum count number, do not exceed 20, it is recommended to keep it unchanged.", "default": 20, "title": "Count", "maximum": 20 }, "description": "Number per page\n\nUsage: Maximum count number, do not exceed 20, it is recommended to keep it unchanged." }, { "name": "max_cursor", "in": "query", "required": false, "schema": { "type": "integer", "description": "Maximum cursor, used for paging, the first page is 0, the second page is the max_cursor value in the first response.", "default": 0, "title": "Max Cursor" }, "description": "Maximum cursor, used for paging, the first page is 0, the second page is the max_cursor value in the first response." }, { "name": "sec_user_id", "in": "query", "required": true, "schema": { "type": "string", "description": "User sec_user_id", "title": "Sec User Id" }, "description": "User sec_user_id", "example": "MS4wLjABAAAANXSltcLCzDGmdNFI2Q_QixVTr67NiYzjKOIP5s03CAE" }, { "name": "sort_type", "in": "query", "required": false, "schema": { "type": "integer", "description": "Sort type, optional values are as follows:\n - `0`: Latest sorting - default\n - `1`: Hottest sorting", "default": 0, "title": "Sort Type" }, "description": "Sort type, optional values are as follows:\n - `0`: Latest sorting - default\n - `1`: Hottest sorting" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:44bcdfb4c7a94fb10e7ebc4c065ce3fa885014430d44347355ca58219bbb9e69" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/app/v3/fetch_user_post_videos?sec_user_id=MS4wLjABAAAANXSltcLCzDGmdNFI2Q_QixVTr67NiYzjKOIP5s03CAE' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-app-v3-fetch_user_post_videos" } }, "/apis/v1/tikhub/douyin/app/v3/fetch_user_series_list": { "get": { "description": "Douyin (app/v3).\n\n### Purpose:\n- Get user's series/playlet collection list\n### Parameters:\n- user_id: User id\n- sec_user_id: User encrypted id\n- cursor: Cursor, used for paging, the first page is 0, the second page is the cursor value in the first response.\n### Return:\n- User series list data\n### Note:\n- This interface returns all series collections published by the user\n- The series_id in the response can be used to get series details and video list\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_app_v3_fetch_user_series_list", "responses": { "200": { "description": "Successful Response\n\n### Return\n- User series list data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_user_series_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "c47f9284c236" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/app/v3/fetch_user_series_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_app_v3_fetch_user_series_list", "method": "GET", "path": "/apis/v1/tikhub/douyin/app/v3/fetch_user_series_list" }, "parameters": [ { "name": "cursor", "in": "query", "required": false, "schema": { "type": "integer", "description": "Cursor, used for paging, the first page is 0, the second page is the cursor value in the first response.", "default": 0, "title": "Cursor" }, "description": "Cursor, used for paging, the first page is 0, the second page is the cursor value in the first response." }, { "name": "sec_user_id", "in": "query", "required": false, "schema": { "type": "string", "description": "User sec id", "default": "", "title": "Sec User Id" }, "description": "User sec id", "example": "MS4wLjABAAAAfAU5kMk-W4569G1z2iRsy8t6-kOxO17Eaz6yte4NQokeUeOpeqTGEc480e34O8lK" }, { "name": "user_id", "in": "query", "required": false, "schema": { "type": "string", "description": "User id", "default": "", "title": "User Id" }, "description": "User id", "example": "3010877781453635" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:67a2a2ce34663e50c1ba78f62a975424bc12d5fdbb5c4a1c33f560437eae2268" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-app-v3-fetch_user_series_list" } }, "/apis/v1/tikhub/douyin/app/v3/fetch_video_comment_replies": { "get": { "description": "Douyin (app/v3).\n\n### Purpose:\n- Get comment replies data of specified video\n### Parameters:\n- item_id: Video id\n- comment_id: Comment id\n- cursor: Cursor, used for paging, the first page is 0, the second page is the cursor value in the first response.\n- count: Number Please keep the default, otherwise there will be BUG.\n### Return:\n- Comment replies data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_app_v3_fetch_video_comment_replies", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Comment replies data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_video_comment_replies", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "54ce94448975" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/app/v3/fetch_video_comment_replies", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_app_v3_fetch_video_comment_replies", "method": "GET", "path": "/apis/v1/tikhub/douyin/app/v3/fetch_video_comment_replies" }, "parameters": [ { "name": "comment_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Comment id", "title": "Comment Id" }, "description": "Comment id", "example": "7354669356632638218" }, { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number Please keep the default, otherwise there will be BUG.", "default": 20, "title": "Count" }, "description": "Number Please keep the default, otherwise there will be BUG." }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "integer", "description": "Cursor, used for paging, the first page is 0, the second page is the cursor value in the first response.", "default": 0, "title": "Cursor" }, "description": "Cursor, used for paging, the first page is 0, the second page is the cursor value in the first response." }, { "name": "item_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Video id", "title": "Item Id" }, "description": "Video id", "example": "7354666303006723354" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:9a677f323913fd85e044b82a9e4202df4a2ab75a4eff43281a010ee2d0bc9dc9" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/app/v3/fetch_video_comment_replies?comment_id=7354669356632638218&item_id=7354666303006723354' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-app-v3-fetch_video_comment_replies" } }, "/apis/v1/tikhub/douyin/app/v3/fetch_video_comments": { "get": { "description": "Douyin (app/v3).\n\n### Purpose:\n- Get single video comments data\n### Parameters:\n- aweme_id: Video id\n- cursor: Cursor, used for paging, the first page is 0, the second page is the cursor value in the first response.\n- count: Number Please keep the default, otherwise there will be BUG.\n### Return:\n- Comments data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_app_v3_fetch_video_comments", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Comments data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_video_comments", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "edf3f6abc913" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/app/v3/fetch_video_comments", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_app_v3_fetch_video_comments", "method": "GET", "path": "/apis/v1/tikhub/douyin/app/v3/fetch_video_comments" }, "parameters": [ { "name": "aweme_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Video id", "title": "Aweme Id" }, "description": "Video id", "example": "7448118827402972455" }, { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number Please keep the default, otherwise there will be BUG.", "default": 20, "title": "Count" }, "description": "Number Please keep the default, otherwise there will be BUG." }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "integer", "description": "Cursor, used for paging, the first page is 0, the second page is the cursor value in the first response.", "default": 0, "title": "Cursor" }, "description": "Cursor, used for paging, the first page is 0, the second page is the cursor value in the first response." } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:ba0b022bed3baa2ae848869b2620b5a0dc659cd8b700d13c7fe3969d42c9ca27" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/app/v3/fetch_video_comments?aweme_id=7448118827402972455' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-app-v3-fetch_video_comments" } }, "/apis/v1/tikhub/douyin/app/v3/fetch_video_high_quality_play_url": { "get": { "description": "Douyin (app/v3). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n\n- Get the highest quality (original upload quality) play URL of the video\n- This interface will return the highest quality play URL, the original upload quality refers to the quality of the video when the user uploads it, usually the highest quality video has an uncompressed bitrate and the file header contains metadata.\n- The highest quality video link cannot be obtained directly from the Douyin APP or web version, and must be obtained through this interface.\n- This interface is very suitable for obtaining high-definition, watermark-free video links, suitable for scenarios that require high-quality videos, such as video editing, archiving, training models, etc.\n- Generally, it can be played online, if not, you can try to download it using IDM or a browser and then play it.\n\n### Parameters\n- aweme_id: Video id, prefer to use aweme_id, if not available, use share_url.\n- share_url: Optional, share link, if the video id is provided, this parameter can be omitted.\n- region: Optional, ISO country code (e.g. \"CN\" / \"US\" / \"HK\") used as the request exit region.\n - Douyin returns CDN URLs based on the request IP. Pass `region=\"CN\"` for users\n located in mainland China to get China-region CDN URLs, which are significantly\n faster than overseas CDNs.\n - If omitted, the request uses the service's own exit IP (typically overseas).\n\n### Return\n- video_id: Video id\n- original_video_url: Highest quality (original upload quality) play URL\n- video_data: Video data, including metadata such as duration, size, etc.\n\n\nPublished reference price: $0.005 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_app_v3_fetch_video_high_quality_play_url", "responses": { "200": { "description": "Successful Response\n\n### Return\n- video_id: Video id\n- original_video_url: Highest quality (original upload quality) play URL\n- video_data: Video data, including metadata such as duration, size, etc.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_video_high_quality_play_url", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.005, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "281f5383c1eb" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/app/v3/fetch_video_high_quality_play_url", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_app_v3_fetch_video_high_quality_play_url", "method": "GET", "path": "/apis/v1/tikhub/douyin/app/v3/fetch_video_high_quality_play_url" }, "parameters": [ { "name": "aweme_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Video id, prefer to use aweme_id, if not available, use share_url.", "title": "Aweme Id" }, "description": "Video id, prefer to use aweme_id, if not available, use share_url.", "example": "7512756548356492544" }, { "name": "region", "in": "query", "required": false, "schema": { "type": "string", "description": "Optional, ISO country code (e.g. CN/US/HK). Pass CN to get China-region CDN URLs for faster download in mainland China.\n\nUsage: Optional, ISO country code (e.g. \"CN\" / \"US\" / \"HK\") used as the request exit region.\n - Douyin returns CDN URLs based on the request IP. Pass `region=\"CN\"` for users\n located in mainland China to get China-region CDN URLs, which are significantly\n faster than overseas CDNs.\n - If omitted, the request uses the service's own exit IP (typically overseas).", "title": "Region" }, "description": "Optional, ISO country code (e.g. CN/US/HK). Pass CN to get China-region CDN URLs for faster download in mainland China.\n\nUsage: Optional, ISO country code (e.g. \"CN\" / \"US\" / \"HK\") used as the request exit region.\n - Douyin returns CDN URLs based on the request IP. Pass `region=\"CN\"` for users\n located in mainland China to get China-region CDN URLs, which are significantly\n faster than overseas CDNs.\n - If omitted, the request uses the service's own exit IP (typically overseas).", "example": "CN" }, { "name": "share_url", "in": "query", "required": false, "schema": { "type": "string", "description": "Optional, share link, if the video id is provided, this parameter can be omitted.", "title": "Share Url" }, "description": "Optional, share link, if the video id is provided, this parameter can be omitted.", "example": "https://www.douyin.com/video/7512756548356492544" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:d3c6610d204bbc3ab5ce1026d831bd2dbe04acd8f74a98bfed1b660ac1be3267" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-app-v3-fetch_video_high_quality_play_url" } }, "/apis/v1/tikhub/douyin/app/v3/fetch_video_mix_detail": { "get": { "description": "Douyin (app/v3).\n\n### Purpose:\n- Get Douyin video mix detail data\n### Parameters:\n- mix_id: Mix id\n### Return:\n- Video mix detail data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_app_v3_fetch_video_mix_detail", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Video mix detail data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_video_mix_detail", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "3d476c715592" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/app/v3/fetch_video_mix_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_app_v3_fetch_video_mix_detail", "method": "GET", "path": "/apis/v1/tikhub/douyin/app/v3/fetch_video_mix_detail" }, "parameters": [ { "name": "mix_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Mix id", "title": "Mix Id" }, "description": "Mix id", "example": "7302011174286002217" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:79de55a4925b7a98cdf3c1a12da0a0bb4b0f64e27d5d24d3de1edd1479644190" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/app/v3/fetch_video_mix_detail?mix_id=7302011174286002217' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-app-v3-fetch_video_mix_detail" } }, "/apis/v1/tikhub/douyin/app/v3/fetch_video_mix_post_list": { "get": { "description": "Douyin (app/v3).\n\n### Purpose:\n- Get Douyin video mix post list data\n### Parameters:\n- mix_id: Mix id\n- cursor: Cursor, used for paging, the first page is 0, the second page is the cursor value in the first response.\n- count: Number Please keep the default, otherwise there will be BUG.\n### Return:\n- Video mix post list data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_app_v3_fetch_video_mix_post_list", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Video mix post list data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_video_mix_post_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "faaf3d2e5446" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/app/v3/fetch_video_mix_post_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_app_v3_fetch_video_mix_post_list", "method": "GET", "path": "/apis/v1/tikhub/douyin/app/v3/fetch_video_mix_post_list" }, "parameters": [ { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number Please keep the default, otherwise there will be BUG.", "default": 20, "title": "Count" }, "description": "Number Please keep the default, otherwise there will be BUG." }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "integer", "description": "Cursor, used for paging, the first page is 0, the second page is the cursor value in the first response.", "default": 0, "title": "Cursor" }, "description": "Cursor, used for paging, the first page is 0, the second page is the cursor value in the first response." }, { "name": "mix_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Mix id", "title": "Mix Id" }, "description": "Mix id", "example": "7302011174286002217" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:27188b27ab89a543def35d03443788ef31164b1344e39b0d9d2d313d3c823fe9" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/app/v3/fetch_video_mix_post_list?mix_id=7302011174286002217' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-app-v3-fetch_video_mix_post_list" } }, "/apis/v1/tikhub/douyin/app/v3/fetch_video_statistics": { "get": { "description": "Douyin (app/v3).\n\n### Purpose:\n- Get the statistical data of the Post according to the video ID\n- Most of the Douyin interfaces no longer return the number of plays of the Post, and can only be obtained through this interface.\n- List of statistics that can be obtained:\n - Like count (digg_count)\n - Download count (download_count)\n - Play count (play_count)\n - Share count (share_count)\n### Parameters:\n- aweme_ids: Video id, supports multiple video ids, separated by commas, no more than 2, single is also possible, no need for commas.\n### Return:\n- Post statistics data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_app_v3_fetch_video_statistics", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Post statistics data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_video_statistics", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "4f841e320a5b" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/app/v3/fetch_video_statistics", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_app_v3_fetch_video_statistics", "method": "GET", "path": "/apis/v1/tikhub/douyin/app/v3/fetch_video_statistics" }, "parameters": [ { "name": "aweme_ids", "in": "query", "required": true, "schema": { "type": "string", "description": "Video id, supports multiple video ids, separated by commas, no more than 2, single is also possible, no need for commas.", "title": "Aweme Ids" }, "description": "Video id, supports multiple video ids, separated by commas, no more than 2, single is also possible, no need for commas.", "example": "7448118827402972455,7126745726494821640" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:96a115a109b74a1d3dcb5564f78dd9d4c114d205434fcd8945b573cc91de5e5f" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/app/v3/fetch_video_statistics?aweme_ids=7448118827402972455%2C7126745726494821640' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-app-v3-fetch_video_statistics" } }, "/apis/v1/tikhub/douyin/app/v3/generate_douyin_short_url": { "get": { "description": "Douyin (app/v3).\n\n### Purpose:\n- Generate Douyin short link\n### Parameters:\n- url: Douyin link\n### Return:\n- Short link data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_app_v3_generate_douyin_short_url", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Short link data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin generate_douyin_short_url", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "0bc8850cee17" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/app/v3/generate_douyin_short_url", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_app_v3_generate_douyin_short_url", "method": "GET", "path": "/apis/v1/tikhub/douyin/app/v3/generate_douyin_short_url" }, "parameters": [ { "name": "url", "in": "query", "required": true, "schema": { "type": "string", "description": "Douyin link", "title": "Url" }, "description": "Douyin link", "example": "https://www.douyin.com/passport/web/logout/" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:d9e5c9fb0ba2a1bde992b513a5bef1e05e7eb9f78185c41d06814777d8bd0746" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/app/v3/generate_douyin_short_url?url=https%3A%2F%2Fwww.douyin.com%2Fpassport%2Fweb%2Flogout%2F' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-app-v3-generate_douyin_short_url" } }, "/apis/v1/tikhub/douyin/app/v3/generate_douyin_video_share_qrcode": { "get": { "description": "Douyin (app/v3).\n\n### Purpose:\n- Generate Douyin video share QR code\n### Parameters:\n- object_id: Video id or author uid\n### Return:\n- QR code data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_app_v3_generate_douyin_video_share_qrcode", "responses": { "200": { "description": "Successful Response\n\n### Return\n- QR code data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin generate_douyin_video_share_qrcode", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "b37c9ab64ef0" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/app/v3/generate_douyin_video_share_qrcode", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_app_v3_generate_douyin_video_share_qrcode", "method": "GET", "path": "/apis/v1/tikhub/douyin/app/v3/generate_douyin_video_share_qrcode" }, "parameters": [ { "name": "object_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Video id", "title": "Object Id" }, "description": "Video id", "example": "7348044435755846962" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:5b7a9fd17c159e0c82bd6449a5a2916f629fd03ca4bf998a084259176213d328" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/app/v3/generate_douyin_video_share_qrcode?object_id=7348044435755846962' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-app-v3-generate_douyin_video_share_qrcode" } }, "/apis/v1/tikhub/douyin/app/v3/handler_user_profile": { "get": { "description": "Douyin (app/v3).\n\n### Purpose:\n- Get information of specified user\n### Parameters:\n- sec_user_id: User sec_user_id\n### Return:\n- User information\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_app_v3_handler_user_profile", "responses": { "200": { "description": "Successful Response\n\n### Return\n- User information", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin handler_user_profile", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "17c1f0bc1626" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/app/v3/handler_user_profile", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_app_v3_handler_user_profile", "method": "GET", "path": "/apis/v1/tikhub/douyin/app/v3/handler_user_profile" }, "parameters": [ { "name": "sec_user_id", "in": "query", "required": true, "schema": { "type": "string", "description": "User sec_user_id", "title": "Sec User Id" }, "description": "User sec_user_id", "example": "MS4wLjABAAAAW9FWcqS7RdQAWPd2AA5fL_ilmqsIFUCQ_Iym6Yh9_cUa6ZRqVLjVQSUjlHrfXY1Y" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:4ced81916d3a065d67730a502526901ce6b14ead6029b1fe45962771f9e57926" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/app/v3/handler_user_profile?sec_user_id=MS4wLjABAAAAW9FWcqS7RdQAWPd2AA5fL_ilmqsIFUCQ_Iym6Yh9_cUa6ZRqVLjVQSUjlHrfXY1Y' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-app-v3-handler_user_profile" } }, "/apis/v1/tikhub/douyin/app/v3/open_douyin_app_to_keyword_search": { "get": { "description": "Douyin (app/v3).\n\n### Purpose:\n- Generate Douyin share link, call Douyin APP, and jump to the specified keyword search result\n\n### Parameters:\n- keyword: Keyword\n\n### Return:\n- Share link\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_app_v3_open_douyin_app_to_keyword_search", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Share link", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin open_douyin_app_to_keyword_search", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "47b3c7626da8" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/app/v3/open_douyin_app_to_keyword_search", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_app_v3_open_douyin_app_to_keyword_search", "method": "GET", "path": "/apis/v1/tikhub/douyin/app/v3/open_douyin_app_to_keyword_search" }, "parameters": [ { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Keyword", "title": "Keyword" }, "description": "Keyword", "example": "Lei Jun" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:3f7749f8035dd84b9fb1d9d72924d486835e8a8ec83953a93308318a19fc66e6" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/app/v3/open_douyin_app_to_keyword_search?keyword=Lei+Jun' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-app-v3-open_douyin_app_to_keyword_search" } }, "/apis/v1/tikhub/douyin/app/v3/open_douyin_app_to_send_private_message": { "get": { "description": "Douyin (app/v3).\n\n### Purpose\n- Generate Douyin share link, call Douyin APP, and send private messages to specified users\n\n### Parameters\n- uid: User id\n- sec_uid: User sec_uid\n- Note: Please make sure that both uid and sec_uid have values, otherwise you cannot send private messages to the specified user.\n\n### Return\n- Share link\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_app_v3_open_douyin_app_to_send_private_message", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Share link", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin open_douyin_app_to_send_private_message", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "d86b6d8d5e09" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/app/v3/open_douyin_app_to_send_private_message", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_app_v3_open_douyin_app_to_send_private_message", "method": "GET", "path": "/apis/v1/tikhub/douyin/app/v3/open_douyin_app_to_send_private_message" }, "parameters": [ { "name": "sec_uid", "in": "query", "required": true, "schema": { "type": "string", "description": "User sec_uid", "title": "Sec Uid" }, "description": "User sec_uid", "example": "MS4wLjABAAAA9y04iBlVdeMQqTJbqsQZKb-tqWqWW29jPVJqideHT70" }, { "name": "uid", "in": "query", "required": true, "schema": { "type": "string", "description": "User id", "title": "Uid" }, "description": "User id", "example": "96874812426" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:3f7749f8035dd84b9fb1d9d72924d486835e8a8ec83953a93308318a19fc66e6" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/app/v3/open_douyin_app_to_send_private_message?sec_uid=MS4wLjABAAAA9y04iBlVdeMQqTJbqsQZKb-tqWqWW29jPVJqideHT70&uid=96874812426' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-app-v3-open_douyin_app_to_send_private_message" } }, "/apis/v1/tikhub/douyin/app/v3/open_douyin_app_to_user_profile": { "get": { "description": "Douyin (app/v3).\n\n### Purpose\n- Generate Douyin share link, call Douyin APP, and jump to the specified user profile\n\n### Parameters\n- uid: User id\n- sec_uid: User sec_uid\n- Note: Please make sure that both uid and sec_uid have values, otherwise you cannot jump to the specified user profile.\n\n### Return\n- Share link\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_app_v3_open_douyin_app_to_user_profile", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Share link", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin open_douyin_app_to_user_profile", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "e6ffafc5778d" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/app/v3/open_douyin_app_to_user_profile", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_app_v3_open_douyin_app_to_user_profile", "method": "GET", "path": "/apis/v1/tikhub/douyin/app/v3/open_douyin_app_to_user_profile" }, "parameters": [ { "name": "sec_uid", "in": "query", "required": true, "schema": { "type": "string", "description": "User sec_uid", "title": "Sec Uid" }, "description": "User sec_uid", "example": "MS4wLjABAAAA9y04iBlVdeMQqTJbqsQZKb-tqWqWW29jPVJqideHT70" }, { "name": "uid", "in": "query", "required": true, "schema": { "type": "string", "description": "User id", "title": "Uid" }, "description": "User id", "example": "96874812426" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:3f7749f8035dd84b9fb1d9d72924d486835e8a8ec83953a93308318a19fc66e6" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/app/v3/open_douyin_app_to_user_profile?sec_uid=MS4wLjABAAAA9y04iBlVdeMQqTJbqsQZKb-tqWqWW29jPVJqideHT70&uid=96874812426' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-app-v3-open_douyin_app_to_user_profile" } }, "/apis/v1/tikhub/douyin/app/v3/open_douyin_app_to_video_detail": { "get": { "description": "Douyin (app/v3).\n\n### Purpose:\n- Generate Douyin share link, call Douyin APP, and jump to the specified video\n\n### Parameters:\n- aweme_id: Video id\n\n### Return:\n- Share link\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_app_v3_open_douyin_app_to_video_detail", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Share link", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin open_douyin_app_to_video_detail", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "3a550c11dd7e" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/app/v3/open_douyin_app_to_video_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_app_v3_open_douyin_app_to_video_detail", "method": "GET", "path": "/apis/v1/tikhub/douyin/app/v3/open_douyin_app_to_video_detail" }, "parameters": [ { "name": "aweme_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Video id", "title": "Aweme Id" }, "description": "Video id", "example": "7348044435755846962" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:3f7749f8035dd84b9fb1d9d72924d486835e8a8ec83953a93308318a19fc66e6" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/app/v3/open_douyin_app_to_video_detail?aweme_id=7348044435755846962' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-app-v3-open_douyin_app_to_video_detail" } }, "/apis/v1/tikhub/douyin/app/v3/register_device": { "get": { "description": "Douyin (app/v3).\n\n### Purpose:\n- Register device in Douyin APP, retrieve device information and device cookies.\n\n### Parameters:\n- proxy: Proxy, with http:// or https://, only supports http proxies.\n - Format: username:password@ip:port\n\n### Return:\n- Device information and device cookies.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_app_v3_register_device", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Device information and device cookies.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin register_device", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "c2d4b32a984f" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/app/v3/register_device", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_app_v3_register_device", "method": "GET", "path": "/apis/v1/tikhub/douyin/app/v3/register_device" }, "parameters": [ { "name": "proxy", "in": "query", "required": false, "schema": { "type": "string", "description": "Proxy, with http:// or https://, only supports http proxies.\n - Format: username:password@ip:port", "default": "", "title": "Proxy" }, "description": "Proxy, with http:// or https://, only supports http proxies.\n - Format: username:password@ip:port" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:ac39c26e0297fc99000d0a8b53b221c396ca4475209f77efabf46921c9033248" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-app-v3-register_device" } }, "/apis/v1/tikhub/douyin/billboard/fetch_city_list": { "get": { "description": "Douyin (billboard).\n\n### Purpose:\n- Get city list\n### Parameters:\n- None\n### Return:\n- Chinese city list\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_billboard_fetch_city_list", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Chinese city list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_city_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a6e8e9acd1b4" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/billboard/fetch_city_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_billboard_fetch_city_list", "method": "GET", "path": "/apis/v1/tikhub/douyin/billboard/fetch_city_list" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:5d49893faeba046eae669fa9ab82ef052e60bae73f79687296d8320b86b07a84" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-billboard-fetch_city_list" } }, "/apis/v1/tikhub/douyin/billboard/fetch_content_tag": { "get": { "description": "Douyin (billboard).\n\n### Purpose:\n- Get vertical content tags\n### Parameters:\n- None\n### Return:\n- Vertical content tags\n### Note:\n- This interface is used to obtain vertical content tags, used to construct the tags/query_tag parameters\n### Example:\nGiven the top-level vertical content tag `Food`, its top-level vertical id is `628`; `Food`'s sub-vertical tag `Wine Tasting`, its sub-vertical id is `62802`.\nThen the constructed tag query parameter is `{\"value\": 628, \"children\": [{\"value\": 62802}]}`\n\nIf you need multiple sub-vertical tags, all food sub-vertical tags are `{\"value\":628,\"children\":[{\"value\":62808},{\"value\":62804},{\"value\":62806},{\"value\":62803},{\"value\":62802},{\"value\":62801},{\"value\":62811},{\"value\":62807},{\"value\":62805},{\"value\":62810}]}`\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_billboard_fetch_content_tag", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Vertical content tags", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_content_tag", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "53993bff270a" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/billboard/fetch_content_tag", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_billboard_fetch_content_tag", "method": "GET", "path": "/apis/v1/tikhub/douyin/billboard/fetch_content_tag" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:bf0f77e1b324857fe3faf9bba2a07a91131577e754bb254d2e46b55ef9c02acd" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-billboard-fetch_content_tag" } }, "/apis/v1/tikhub/douyin/billboard/fetch_hot_account_fans_interest_account_list": { "get": { "description": "Douyin (billboard).\n\n### Purpose:\n- Get the fan interest author 20 users\n### Parameters:\n- sec_uid: User sec_id\n### Return:\n- Fan interest author 20 users\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_billboard_fetch_hot_account_fans_interest_account_list", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Fan interest author 20 users", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_hot_account_fans_interest_account_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "5a60380372c7" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/billboard/fetch_hot_account_fans_interest_account_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_billboard_fetch_hot_account_fans_interest_account_list", "method": "GET", "path": "/apis/v1/tikhub/douyin/billboard/fetch_hot_account_fans_interest_account_list" }, "parameters": [ { "name": "sec_uid", "in": "query", "required": true, "schema": { "type": "string", "description": "User sec_id", "title": "Sec Uid" }, "description": "User sec_id", "example": "MS4wLjABAAAA8U_l6rBzmy7bcy6xOJel4v0RzoR_wfAubGPeJimN__4" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:fda7cb6cfd4c201acc845138b069dba207b5218860bef6700a993f86cbf90c46" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/billboard/fetch_hot_account_fans_interest_account_list?sec_uid=MS4wLjABAAAA8U_l6rBzmy7bcy6xOJel4v0RzoR_wfAubGPeJimN__4' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-billboard-fetch_hot_account_fans_interest_account_list" } }, "/apis/v1/tikhub/douyin/billboard/fetch_hot_account_fans_interest_search_list": { "get": { "description": "Douyin (billboard).\n\n### Purpose:\n- Get the fan interest search term in the last 3 days 10 search terms\n### Parameters:\n- sec_uid: User sec_id\n### Return:\n- Fan interest search term in the last 3 days 10 search terms\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_billboard_fetch_hot_account_fans_interest_search_list", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Fan interest search term in the last 3 days 10 search terms", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_hot_account_fans_interest_search_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "6a6cbb24a16b" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/billboard/fetch_hot_account_fans_interest_search_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_billboard_fetch_hot_account_fans_interest_search_list", "method": "GET", "path": "/apis/v1/tikhub/douyin/billboard/fetch_hot_account_fans_interest_search_list" }, "parameters": [ { "name": "sec_uid", "in": "query", "required": true, "schema": { "type": "string", "description": "User sec_id", "title": "Sec Uid" }, "description": "User sec_id", "example": "MS4wLjABAAAA8U_l6rBzmy7bcy6xOJel4v0RzoR_wfAubGPeJimN__4" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:7b274c743f26a5e436ce5e19fd9bafa9894427a750a779315e68a97db98efde1" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/billboard/fetch_hot_account_fans_interest_search_list?sec_uid=MS4wLjABAAAA8U_l6rBzmy7bcy6xOJel4v0RzoR_wfAubGPeJimN__4' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-billboard-fetch_hot_account_fans_interest_search_list" } }, "/apis/v1/tikhub/douyin/billboard/fetch_hot_account_fans_interest_topic_list": { "get": { "description": "Douyin (billboard).\n\n### Purpose:\n- Get the fan interest topic in the last 3 days 10 topics\n### Parameters:\n- sec_uid: User sec_id\n### Return:\n- Fan interest topic in the last 3 days 10 topics\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_billboard_fetch_hot_account_fans_interest_topic_list", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Fan interest topic in the last 3 days 10 topics", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_hot_account_fans_interest_topic_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "e310e133f569" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/billboard/fetch_hot_account_fans_interest_topic_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_billboard_fetch_hot_account_fans_interest_topic_list", "method": "GET", "path": "/apis/v1/tikhub/douyin/billboard/fetch_hot_account_fans_interest_topic_list" }, "parameters": [ { "name": "sec_uid", "in": "query", "required": true, "schema": { "type": "string", "description": "User sec_id", "title": "Sec Uid" }, "description": "User sec_id", "example": "MS4wLjABAAAA8U_l6rBzmy7bcy6xOJel4v0RzoR_wfAubGPeJimN__4" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:c222d2cf2c0503cfdb4332a748b4a2d30648606b1d80f511c1b2ff3ea6904e36" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/billboard/fetch_hot_account_fans_interest_topic_list?sec_uid=MS4wLjABAAAA8U_l6rBzmy7bcy6xOJel4v0RzoR_wfAubGPeJimN__4' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-billboard-fetch_hot_account_fans_interest_topic_list" } }, "/apis/v1/tikhub/douyin/billboard/fetch_hot_account_fans_portrait_list": { "get": { "description": "Douyin (billboard).\n\n### Purpose:\n- Get the fan portrait\n### Parameters:\n- sec_uid: User sec_id\n- option: Option\n - 1 Mobile price\n - 2 Gender distribution\n - 3 Age distribution\n - 4 Regional distribution - province\n - 5 Regional distribution - city\n - 6 City level\n - 7 Mobile brand distribution\n - 8 Interest tag analysis percentage\n### Return:\n- Fan portrait\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_billboard_fetch_hot_account_fans_portrait_list", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Fan portrait", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_hot_account_fans_portrait_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "2190b6f20db0" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/billboard/fetch_hot_account_fans_portrait_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_billboard_fetch_hot_account_fans_portrait_list", "method": "GET", "path": "/apis/v1/tikhub/douyin/billboard/fetch_hot_account_fans_portrait_list" }, "parameters": [ { "name": "option", "in": "query", "required": false, "schema": { "type": "integer", "description": "Options: 1=Phone price distribution, 2=Gender distribution, 3=Age distribution, 4=Regional distribution by province, 5=Regional distribution by city, 6=City tier, 7=Phone brand distribution, 8=Interest tag analysis (percentage)", "default": 1, "title": "Option" }, "description": "Options: 1=Phone price distribution, 2=Gender distribution, 3=Age distribution, 4=Regional distribution by province, 5=Regional distribution by city, 6=City tier, 7=Phone brand distribution, 8=Interest tag analysis (percentage)", "example": 1 }, { "name": "sec_uid", "in": "query", "required": true, "schema": { "type": "string", "description": "User sec_id", "title": "Sec Uid" }, "description": "User sec_id", "example": "MS4wLjABAAAA8U_l6rBzmy7bcy6xOJel4v0RzoR_wfAubGPeJimN__4" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:7493e8fb0fcd74c7e107b624d1f63c8e8b02eb9a1f42c17357aff593d5b10096" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/billboard/fetch_hot_account_fans_portrait_list?option=1&sec_uid=MS4wLjABAAAA8U_l6rBzmy7bcy6xOJel4v0RzoR_wfAubGPeJimN__4' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-billboard-fetch_hot_account_fans_portrait_list" } }, "/apis/v1/tikhub/douyin/billboard/fetch_hot_account_item_analysis_list": { "get": { "description": "Douyin (billboard).\n\n### Purpose\n- Get the account work analysis\n\n### Parameters\n- sec_uid: User sec_id\n\n### Return\n- Account work analysis\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_billboard_fetch_hot_account_item_analysis_list", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Account work analysis", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_hot_account_item_analysis_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "5ee00f27f833" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/billboard/fetch_hot_account_item_analysis_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_billboard_fetch_hot_account_item_analysis_list", "method": "GET", "path": "/apis/v1/tikhub/douyin/billboard/fetch_hot_account_item_analysis_list" }, "parameters": [ { "name": "sec_uid", "in": "query", "required": true, "schema": { "type": "string", "description": "User sec_id", "title": "Sec Uid" }, "description": "User sec_id", "example": "MS4wLjABAAAA8U_l6rBzmy7bcy6xOJel4v0RzoR_wfAubGPeJimN__4" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:415a41fb529e8eb581e7c682b6d46dc87b5efe1e7764a5dc4c83002a2086273c" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/billboard/fetch_hot_account_item_analysis_list?sec_uid=MS4wLjABAAAA8U_l6rBzmy7bcy6xOJel4v0RzoR_wfAubGPeJimN__4' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-billboard-fetch_hot_account_item_analysis_list" } }, "/apis/v1/tikhub/douyin/billboard/fetch_hot_account_list": { "post": { "description": "Douyin (billboard).\n\n### Purpose:\n- Get the hot account\n### Parameters:\n- date_window: Time window in hours, one of 24/72/168 (last 1 day / 3 days / 7 days), default 24\n- page_num: Page number, default 1\n- page_size: Number of items per page, default 10\n- query_tag: Vertical category tag filter, empty for all, tag ids come from the fetch_content_tag endpoint\n### Request Example:\n```json\n{\n \"date_window\": 24,\n \"page_num\": 1,\n \"page_size\": 10,\n \"query_tag\": {\"value\": 628, \"children\": [{\"value\": 62808}, {\"value\": 62804}]}\n}\n```\n### Return:\n- Hot account\n\nAPI references: `fetch_content_tag` = `GET /tikhub/douyin/billboard/fetch_content_tag` (operationId: `get_tikhub_douyin_billboard_fetch_content_tag`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_billboard_fetch_hot_account_list", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Hot account", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_hot_account_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "e7a6e268b8b0" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/billboard/fetch_hot_account_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_billboard_fetch_hot_account_list", "method": "POST", "path": "/apis/v1/tikhub/douyin/billboard/fetch_hot_account_list" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "date_window": { "type": "integer", "title": "Date Window", "description": "Time window (hours): 24=last 1 day, 72=last 3 days, 168=last 7 days; default 24\n\nUsage: Time window in hours, one of 24/72/168 (last 1 day / 3 days / 7 days), default 24", "default": 24 }, "page_num": { "type": "integer", "title": "Page Num", "description": "Page number, default 1", "default": 1 }, "page_size": { "type": "integer", "title": "Page Size", "description": "Number of items per page, default 10", "default": 10 }, "query_tag": { "description": "Vertical tag filter; leave empty for all. Tag IDs are obtained from the fetch_content_tag endpoint.\n\nUsage: Vertical category tag filter, empty for all, tag ids come from the fetch_content_tag endpoint\n\nAPI references: `fetch_content_tag` = `GET /tikhub/douyin/billboard/fetch_content_tag` (operationId: `get_tikhub_douyin_billboard_fetch_content_tag`).", "example": { "children": [ { "value": 62808 }, { "value": 62804 } ], "value": 628 }, "allOf": [ { "properties": { "value": { "title": "Value", "description": "Top-level vertical category tag id, obtained from the fetch_content_tag endpoint\n\nAPI references: `fetch_content_tag` = `GET /tikhub/douyin/billboard/fetch_content_tag` (operationId: `get_tikhub_douyin_billboard_fetch_content_tag`).", "type": [ "integer", "null" ] }, "children": { "title": "Children", "description": "Sub-level vertical category tags, omit for all under this top-level tag", "items": { "properties": { "value": { "title": "Value", "description": "Sub-level vertical category tag id, obtained from the fetch_content_tag endpoint\n\nAPI references: `fetch_content_tag` = `GET /tikhub/douyin/billboard/fetch_content_tag` (operationId: `get_tikhub_douyin_billboard_fetch_content_tag`).", "type": [ "integer", "null" ] } }, "type": "object", "title": "BillboardTagChild" }, "type": [ "array", "null" ] } }, "type": "object", "title": "BillboardTag" } ] } }, "type": "object", "title": "Body_fetch_hot_account_list_api_v1_douyin_billboard_fetch_hot_account_list_post" } } } }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:8a9a03aa69e8f6aac0f41a2b1506a50f8152603795b6799b9ff3a136fb52678b" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-billboard-fetch_hot_account_list" } }, "/apis/v1/tikhub/douyin/billboard/fetch_hot_account_search_list": { "get": { "description": "Douyin (billboard).\n\n### Purpose:\n- Get the search username or Douyin number\n### Parameters:\n- keyword: Search username or Douyin number\n- cursor: Cursor, default empty\n### Return:\n- Search result\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_billboard_fetch_hot_account_search_list", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Search result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_hot_account_search_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "2f68eb83e361" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/billboard/fetch_hot_account_search_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_billboard_fetch_hot_account_search_list", "method": "GET", "path": "/apis/v1/tikhub/douyin/billboard/fetch_hot_account_search_list" }, "parameters": [ { "name": "cursor", "in": "query", "required": true, "schema": { "type": "integer", "description": "Cursor, defaults to empty", "title": "Cursor" }, "description": "Cursor, defaults to empty", "example": 0 }, { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Username or Douyin ID to search", "title": "Keyword" }, "description": "Username or Douyin ID to search", "example": "rmrbxmt" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:9cd7af68c05ad72c7ec544cf5463bcd011f5fb77d3aee2fd500541ea3f1b38a5" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/billboard/fetch_hot_account_search_list?cursor=0&keyword=rmrbxmt' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-billboard-fetch_hot_account_search_list" } }, "/apis/v1/tikhub/douyin/billboard/fetch_hot_account_trends_list": { "get": { "description": "Douyin (billboard).\n\n### Purpose:\n- Get the account fan data trend\n### Parameters:\n- sec_uid: User sec_id\n- option: Option, 2 New like 3 New work 4 New comment 5 New share\n- date_window: Data point granularity in hours, one of 1/24 (one point per hour / per day), default 24\n### Return:\n- Account fan data trend\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_billboard_fetch_hot_account_trends_list", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Account fan data trend", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_hot_account_trends_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "f2d210c02b65" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/billboard/fetch_hot_account_trends_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_billboard_fetch_hot_account_trends_list", "method": "GET", "path": "/apis/v1/tikhub/douyin/billboard/fetch_hot_account_trends_list" }, "parameters": [ { "name": "date_window", "in": "query", "required": false, "schema": { "type": "integer", "description": "Data point granularity (hours): 1=one point per hour, 24=one point per day; default 24\n\nUsage: Data point granularity in hours, one of 1/24 (one point per hour / per day), default 24", "example": 1, "default": 24, "title": "Date Window" }, "description": "Data point granularity (hours): 1=one point per hour, 24=one point per day; default 24\n\nUsage: Data point granularity in hours, one of 1/24 (one point per hour / per day), default 24" }, { "name": "option", "in": "query", "required": false, "schema": { "type": "integer", "description": "Options: 2=New likes, 3=New posts, 4=New comments, 5=New shares", "example": 2, "default": 2, "title": "Option" }, "description": "Options: 2=New likes, 3=New posts, 4=New comments, 5=New shares" }, { "name": "sec_uid", "in": "query", "required": true, "schema": { "type": "string", "description": "User sec_id", "title": "Sec Uid" }, "description": "User sec_id", "example": "MS4wLjABAAAA8U_l6rBzmy7bcy6xOJel4v0RzoR_wfAubGPeJimN__4" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:dd81c4006f1c97330a0f48217d0cd68c3f1ed9a52042a6ec34ede7188b3d86fc" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/billboard/fetch_hot_account_trends_list?sec_uid=MS4wLjABAAAA8U_l6rBzmy7bcy6xOJel4v0RzoR_wfAubGPeJimN__4' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-billboard-fetch_hot_account_trends_list" } }, "/apis/v1/tikhub/douyin/billboard/fetch_hot_calendar_detail": { "get": { "description": "Douyin (billboard).\n\n### Purpose:\n- Get the activity calendar details\n### Parameters:\n- calendar_id: Activity id\n### Return:\n- Activity calendar details\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_billboard_fetch_hot_calendar_detail", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Activity calendar details", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_hot_calendar_detail", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "e9ea705f4ac8" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/billboard/fetch_hot_calendar_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_billboard_fetch_hot_calendar_detail", "method": "GET", "path": "/apis/v1/tikhub/douyin/billboard/fetch_hot_calendar_detail" }, "parameters": [ { "name": "calendar_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Activity id", "title": "Calendar Id" }, "description": "Activity id", "example": "1720" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:1c3b6aea6ab7eebd43f51109a161cea17a56480bad9732da5f445498fd8a2d90" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/billboard/fetch_hot_calendar_detail?calendar_id=1720' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-billboard-fetch_hot_calendar_detail" } }, "/apis/v1/tikhub/douyin/billboard/fetch_hot_calendar_list": { "post": { "description": "Douyin (billboard).\n\n### Purpose:\n- Get the activity calendar\n### Parameters:\n- city_code: City code, get from city list, empty for all\n- category_code: Hot list category code, get from hot list category, empty for all\n- end_date: Snapshot end time format 10 digit timestamp\n- start_date: Snapshot start time format 10 digit timestamp\n### Return:\n- Activity calendar\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_billboard_fetch_hot_calendar_list", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Activity calendar", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_hot_calendar_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "0894fab48f22" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/billboard/fetch_hot_calendar_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_billboard_fetch_hot_calendar_list", "method": "POST", "path": "/apis/v1/tikhub/douyin/billboard/fetch_hot_calendar_list" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "city_code": { "type": "string", "title": "City Code", "description": "City code from city list; leave empty for all\n\nUsage: City code, get from city list, empty for all", "default": "" }, "category_code": { "type": "string", "title": "Category Code", "description": "Hot-spot ranking category code; obtained from the hot-spot ranking categories; leave empty for all\n\nUsage: Hot list category code, get from hot list category, empty for all", "default": "" }, "end_date": { "type": "integer", "title": "End Date", "description": "Snapshot end time, 10-digit Unix timestamp format\n\nUsage: Snapshot end time format 10 digit timestamp", "default": 1735488000 }, "start_date": { "type": "integer", "title": "Start Date", "description": "Snapshot start time format 10 digit timestamp", "default": 1734902400 } }, "type": "object", "title": "Body_fetch_hot_calendar_list_api_v1_douyin_billboard_fetch_hot_calendar_list_post" } } } }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:f79828eff95daefb3f22fb9399fa3a4cfedb20ffc28801e81168a559bee92280" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-billboard-fetch_hot_calendar_list" } }, "/apis/v1/tikhub/douyin/billboard/fetch_hot_category_list": { "get": { "description": "Douyin (billboard).\n\n### Purpose:\n- Get the id and popularity of the hot list category\n- Note: Using start_date and end_date parameters requires removing the snapshot_time parameter\n- Note: snapshot_time and start_date, end_date parameters cannot be empty at the same time\n### Parameters:\n- billboard_type: Billboard type\n - rise Rising hot list\n - city City hot list\n - total Total hot list\n- snapshot_time: Snapshot time\n- start_date: Snapshot start time\n- end_date: Snapshot end time\n- keyword: Hot search term\n### Return:\n- Hot category list\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_billboard_fetch_hot_category_list", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Hot category list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_hot_category_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "e64481e39c31" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/billboard/fetch_hot_category_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_billboard_fetch_hot_category_list", "method": "GET", "path": "/apis/v1/tikhub/douyin/billboard/fetch_hot_category_list" }, "parameters": [ { "name": "billboard_type", "in": "query", "required": true, "schema": { "type": "string", "description": "Ranking type\n\nUsage: Billboard type\n - rise Rising hot list\n - city City hot list\n - total Total hot list", "title": "Billboard Type" }, "description": "Ranking type\n\nUsage: Billboard type\n - rise Rising hot list\n - city City hot list\n - total Total hot list", "example": "rise" }, { "name": "end_date", "in": "query", "required": false, "schema": { "type": "string", "description": "Snapshot end time, yyyyMMdd format", "default": "", "title": "End Date" }, "description": "Snapshot end time, yyyyMMdd format" }, { "name": "keyword", "in": "query", "required": false, "schema": { "type": "string", "description": "Hot search keyword", "default": "", "title": "Keyword" }, "description": "Hot search keyword" }, { "name": "snapshot_time", "in": "query", "required": false, "schema": { "type": "string", "description": "Snapshot time, yyyyMMddHHmmss format", "default": "20250106151500", "title": "Snapshot Time" }, "description": "Snapshot time, yyyyMMddHHmmss format" }, { "name": "start_date", "in": "query", "required": false, "schema": { "type": "string", "description": "Snapshot start time, yyyyMMdd format", "default": "", "title": "Start Date" }, "description": "Snapshot start time, yyyyMMdd format" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:d1b74e2e96dabbe0bf8b07377d4dda3c181c5575766206dfedd644369233f13a" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/billboard/fetch_hot_category_list?billboard_type=rise' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-billboard-fetch_hot_category_list" } }, "/apis/v1/tikhub/douyin/billboard/fetch_hot_challenge_list": { "get": { "description": "Douyin (billboard).\n\n### Purpose:\n- Get the challenge list\n### Parameters:\n- page: Page number\n- page_size: Number of items per page\n- keyword: Hot search term\n### Return:\n- Challenge list\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_billboard_fetch_hot_challenge_list", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Challenge list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_hot_challenge_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "3957e38f1e0f" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/billboard/fetch_hot_challenge_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_billboard_fetch_hot_challenge_list", "method": "GET", "path": "/apis/v1/tikhub/douyin/billboard/fetch_hot_challenge_list" }, "parameters": [ { "name": "keyword", "in": "query", "required": false, "schema": { "type": "string", "description": "Hot search keyword", "default": "", "title": "Keyword" }, "description": "Hot search keyword" }, { "name": "page", "in": "query", "required": true, "schema": { "type": "integer", "description": "Page number", "title": "Page" }, "description": "Page number", "example": 1 }, { "name": "page_size", "in": "query", "required": true, "schema": { "type": "integer", "description": "Items per page", "title": "Page Size" }, "description": "Items per page", "example": 10 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e448319984115fdbb436a434cd9ca369e08d9ec558d8f84a823cc887f1971c6a" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/billboard/fetch_hot_challenge_list?page=1&page_size=10' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-billboard-fetch_hot_challenge_list" } }, "/apis/v1/tikhub/douyin/billboard/fetch_hot_city_list": { "get": { "description": "Douyin (billboard).\n\n### Purpose:\n- Get the city hot list\n### Parameters:\n- page: Page number\n- page_size: Number of items per page\n- order: Sorting method\n - rank Sort by popularity\n - rank_diff Sort by ranking change\n- city_code: City code, get from city list, empty for all\n- sentence_tag: Hot category tag, get from hot list category, multiple categories separated by commas, empty for all\n- keyword: Hot search term\n### Return:\n- City hot list\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_billboard_fetch_hot_city_list", "responses": { "200": { "description": "Successful Response\n\n### Return\n- City hot list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_hot_city_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "b2dd9231951f" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/billboard/fetch_hot_city_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_billboard_fetch_hot_city_list", "method": "GET", "path": "/apis/v1/tikhub/douyin/billboard/fetch_hot_city_list" }, "parameters": [ { "name": "city_code", "in": "query", "required": false, "schema": { "type": "string", "description": "City code from city list; leave empty for all\n\nUsage: City code, get from city list, empty for all", "default": "", "title": "City Code" }, "description": "City code from city list; leave empty for all\n\nUsage: City code, get from city list, empty for all" }, { "name": "keyword", "in": "query", "required": false, "schema": { "type": "string", "description": "Hot search keyword", "default": "", "title": "Keyword" }, "description": "Hot search keyword" }, { "name": "order", "in": "query", "required": true, "schema": { "type": "string", "description": "Sorting method\n - rank Sort by popularity\n - rank_diff Sort by ranking change", "example": "rank", "title": "Order" }, "description": "Sorting method\n - rank Sort by popularity\n - rank_diff Sort by ranking change" }, { "name": "page", "in": "query", "required": true, "schema": { "type": "integer", "description": "Page number", "title": "Page" }, "description": "Page number", "example": 1 }, { "name": "page_size", "in": "query", "required": true, "schema": { "type": "integer", "description": "Items per page", "title": "Page Size" }, "description": "Items per page", "example": 10 }, { "name": "sentence_tag", "in": "query", "required": false, "schema": { "type": "string", "description": "Hot-spot category tag; obtained from the hot-spot ranking categories; multiple values separated by commas; leave empty for all", "default": "", "title": "Sentence Tag" }, "description": "Hot-spot category tag; obtained from the hot-spot ranking categories; multiple values separated by commas; leave empty for all" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:83b12e986d09683a910ec0654725f31f68b286a6622b56f37c548843aae6cd88" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/billboard/fetch_hot_city_list?order=rank&page=1&page_size=10' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-billboard-fetch_hot_city_list" } }, "/apis/v1/tikhub/douyin/billboard/fetch_hot_comment_word_list": { "get": { "description": "Douyin (billboard).\n\n### Purpose:\n- Get the work comment analysis word cloud weight\n### Parameters:\n- aweme_id: Work id\n### Return:\n- Work comment analysis word cloud weight\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_billboard_fetch_hot_comment_word_list", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Work comment analysis word cloud weight", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_hot_comment_word_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "cc5fabd3e0a5" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/billboard/fetch_hot_comment_word_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_billboard_fetch_hot_comment_word_list", "method": "GET", "path": "/apis/v1/tikhub/douyin/billboard/fetch_hot_comment_word_list" }, "parameters": [ { "name": "aweme_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Post ID", "title": "Aweme Id" }, "description": "Post ID", "example": "7456035425539329340" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:9044b24d9571bdafd628a35c98324c4a8b2b46029958d63e741ebb5a21f16145" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/billboard/fetch_hot_comment_word_list?aweme_id=7456035425539329340' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-billboard-fetch_hot_comment_word_list" } }, "/apis/v1/tikhub/douyin/billboard/fetch_hot_item_trends_list": { "get": { "description": "Douyin (billboard).\n\n### Purpose:\n- Get the work data trend\n### Parameters:\n- aweme_id: Work id\n- option: Option, 7 Like 8 Share 9 Comment\n- date_window: Data point granularity, one of 1/2 (by hour / by day), default 1\n### Return:\n- Work data trend\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_billboard_fetch_hot_item_trends_list", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Work data trend", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_hot_item_trends_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "8517d8715dac" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/billboard/fetch_hot_item_trends_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_billboard_fetch_hot_item_trends_list", "method": "GET", "path": "/apis/v1/tikhub/douyin/billboard/fetch_hot_item_trends_list" }, "parameters": [ { "name": "aweme_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Post ID", "default": "", "title": "Aweme Id" }, "description": "Post ID" }, { "name": "date_window", "in": "query", "required": false, "schema": { "type": "integer", "description": "Data point granularity: 1=hourly, 2=daily; default 1\n\nUsage: Data point granularity, one of 1/2 (by hour / by day), default 1", "example": 1, "default": 1, "title": "Date Window" }, "description": "Data point granularity: 1=hourly, 2=daily; default 1\n\nUsage: Data point granularity, one of 1/2 (by hour / by day), default 1" }, { "name": "option", "in": "query", "required": false, "schema": { "type": "integer", "description": "Options: 7=Likes, 8=Shares, 9=Comments", "example": 7, "default": 7, "title": "Option" }, "description": "Options: 7=Likes, 8=Shares, 9=Comments" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:165673d96e1303735138483d4dbafb11f40ad92cc91ba38d0fa84230862fcd2d" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-billboard-fetch_hot_item_trends_list" } }, "/apis/v1/tikhub/douyin/billboard/fetch_hot_rise_list": { "get": { "description": "Douyin (billboard).\n\n### Purpose:\n- Get the rising hot list\n### Parameters:\n- page: Page number\n- page_size: Number of items per page\n- order: Sorting method\n - rank Sort by popularity\n - rank_diff Sort by ranking change\n- sentence_tag: Hot category tag, get from hot list category, multiple categories separated by commas, empty for all\n- keyword: Hot search term\n### Return:\n- Rising hot list\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_billboard_fetch_hot_rise_list", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Rising hot list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_hot_rise_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "14a6f1cdef93" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/billboard/fetch_hot_rise_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_billboard_fetch_hot_rise_list", "method": "GET", "path": "/apis/v1/tikhub/douyin/billboard/fetch_hot_rise_list" }, "parameters": [ { "name": "keyword", "in": "query", "required": false, "schema": { "type": "string", "description": "Hot search keyword", "default": "", "title": "Keyword" }, "description": "Hot search keyword" }, { "name": "order", "in": "query", "required": true, "schema": { "type": "string", "description": "Sorting method\n - rank Sort by popularity\n - rank_diff Sort by ranking change", "title": "Order" }, "description": "Sorting method\n - rank Sort by popularity\n - rank_diff Sort by ranking change", "example": "rank" }, { "name": "page", "in": "query", "required": true, "schema": { "type": "integer", "description": "Page number", "title": "Page" }, "description": "Page number", "example": 1 }, { "name": "page_size", "in": "query", "required": true, "schema": { "type": "integer", "description": "Items per page", "title": "Page Size" }, "description": "Items per page", "example": 10 }, { "name": "sentence_tag", "in": "query", "required": false, "schema": { "type": "string", "description": "Hot-spot category tag; obtained from the hot-spot ranking categories; multiple values separated by commas; leave empty for all", "default": "", "title": "Sentence Tag" }, "description": "Hot-spot category tag; obtained from the hot-spot ranking categories; multiple values separated by commas; leave empty for all" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:419b6a26d57e5a40fb7c6c00a97f9020a7f5328ee0c2f9f6558b5a8ff9aedc27" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/billboard/fetch_hot_rise_list?order=rank&page=1&page_size=10' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-billboard-fetch_hot_rise_list" } }, "/apis/v1/tikhub/douyin/billboard/fetch_hot_total_high_fan_list": { "post": { "description": "Douyin (billboard).\n\n### Purpose:\n- Get the high fan rate list\n### Parameters:\n- page: Page number\n- page_size: Number of items per page\n- date_window: Time window in hours, one of 1/24/72/168 (last 1 hour / 1 day / 3 days / 7 days), default 24\n- keyword: Search keyword to filter the billboard, empty for all\n- tags: Vertical category tag filter, empty for all, tag ids come from the fetch_content_tag endpoint\n### Request Example:\n```json\n{\n \"page\": 1,\n \"page_size\": 10,\n \"date_window\": 24,\n \"keyword\": \"\",\n \"tags\": [\n {\"value\": 628, \"children\": [{\"value\": 62808}, {\"value\": 62804}]}\n ]\n}\n```\n### Return:\n- High fan rate list\n\nAPI references: `fetch_content_tag` = `GET /tikhub/douyin/billboard/fetch_content_tag` (operationId: `get_tikhub_douyin_billboard_fetch_content_tag`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_billboard_fetch_hot_total_high_fan_list", "responses": { "200": { "description": "Successful Response\n\n### Return\n- High fan rate list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_hot_total_high_fan_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "1814eaa3fa68" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/billboard/fetch_hot_total_high_fan_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_billboard_fetch_hot_total_high_fan_list", "method": "POST", "path": "/apis/v1/tikhub/douyin/billboard/fetch_hot_total_high_fan_list" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "page": { "type": "integer", "title": "Page", "description": "Page number", "default": 1 }, "page_size": { "type": "integer", "title": "Page Size", "description": "Items per page", "default": 10 }, "date_window": { "type": "integer", "title": "Date Window", "description": "Time window (hours): 1=last 1 hour, 24=last 1 day, 72=last 3 days, 168=last 7 days; default 24\n\nUsage: Time window in hours, one of 1/24/72/168 (last 1 hour / 1 day / 3 days / 7 days), default 24", "default": 24 }, "keyword": { "type": "string", "title": "Keyword", "description": "Search keyword for filtering the leaderboard; empty=all\n\nUsage: Search keyword to filter the billboard, empty for all", "default": "" }, "tags": { "items": { "properties": { "value": { "title": "Value", "description": "Top-level vertical category tag id, obtained from the fetch_content_tag endpoint\n\nAPI references: `fetch_content_tag` = `GET /tikhub/douyin/billboard/fetch_content_tag` (operationId: `get_tikhub_douyin_billboard_fetch_content_tag`).", "type": [ "integer", "null" ] }, "children": { "title": "Children", "description": "Sub-level vertical category tags, omit for all under this top-level tag", "items": { "properties": { "value": { "title": "Value", "description": "Sub-level vertical category tag id, obtained from the fetch_content_tag endpoint\n\nAPI references: `fetch_content_tag` = `GET /tikhub/douyin/billboard/fetch_content_tag` (operationId: `get_tikhub_douyin_billboard_fetch_content_tag`).", "type": [ "integer", "null" ] } }, "type": "object", "title": "BillboardTagChild" }, "type": [ "array", "null" ] } }, "type": "object", "title": "BillboardTag" }, "type": "array", "title": "Tags", "description": "Vertical tag filter; leave empty for all. Tag IDs are obtained from the fetch_content_tag endpoint.\n\nUsage: Vertical category tag filter, empty for all, tag ids come from the fetch_content_tag endpoint\n\nAPI references: `fetch_content_tag` = `GET /tikhub/douyin/billboard/fetch_content_tag` (operationId: `get_tikhub_douyin_billboard_fetch_content_tag`).", "example": [ { "children": [ { "value": 62808 }, { "value": 62804 } ], "value": 628 } ] } }, "type": "object", "title": "Body_fetch_hot_total_high_fan_list_api_v1_douyin_billboard_fetch_hot_total_high_fan_list_post" } } } }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:5532b66d570d5d22f33aba7628c28f4d6ce7398771ca6d29338c7e8ced7895ef" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-billboard-fetch_hot_total_high_fan_list" } }, "/apis/v1/tikhub/douyin/billboard/fetch_hot_total_high_like_list": { "post": { "description": "Douyin (billboard).\n\n### Purpose:\n- Get the high like rate list\n### Parameters:\n- page: Page number\n- page_size: Number of items per page\n- date_window: Time window in hours, one of 1/24/72/168 (last 1 hour / 1 day / 3 days / 7 days), default 24\n- keyword: Search keyword to filter the billboard, empty for all\n- tags: Vertical category tag filter, empty for all, tag ids come from the fetch_content_tag endpoint\n### Request Example:\n```json\n{\n \"page\": 1,\n \"page_size\": 10,\n \"date_window\": 24,\n \"keyword\": \"\",\n \"tags\": [\n {\"value\": 628, \"children\": [{\"value\": 62808}, {\"value\": 62804}]}\n ]\n}\n```\n### Return:\n- High like rate list\n\nAPI references: `fetch_content_tag` = `GET /tikhub/douyin/billboard/fetch_content_tag` (operationId: `get_tikhub_douyin_billboard_fetch_content_tag`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_billboard_fetch_hot_total_high_like_list", "responses": { "200": { "description": "Successful Response\n\n### Return\n- High like rate list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_hot_total_high_like_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "e63cb501f807" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/billboard/fetch_hot_total_high_like_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_billboard_fetch_hot_total_high_like_list", "method": "POST", "path": "/apis/v1/tikhub/douyin/billboard/fetch_hot_total_high_like_list" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "page": { "type": "integer", "title": "Page", "description": "Page number", "default": 1 }, "page_size": { "type": "integer", "title": "Page Size", "description": "Items per page", "default": 10 }, "date_window": { "type": "integer", "title": "Date Window", "description": "Time window (hours): 1=last 1 hour, 24=last 1 day, 72=last 3 days, 168=last 7 days; default 24\n\nUsage: Time window in hours, one of 1/24/72/168 (last 1 hour / 1 day / 3 days / 7 days), default 24", "default": 24 }, "keyword": { "type": "string", "title": "Keyword", "description": "Search keyword for filtering the leaderboard; empty=all\n\nUsage: Search keyword to filter the billboard, empty for all", "default": "" }, "tags": { "items": { "properties": { "value": { "title": "Value", "description": "Top-level vertical category tag id, obtained from the fetch_content_tag endpoint\n\nAPI references: `fetch_content_tag` = `GET /tikhub/douyin/billboard/fetch_content_tag` (operationId: `get_tikhub_douyin_billboard_fetch_content_tag`).", "type": [ "integer", "null" ] }, "children": { "title": "Children", "description": "Sub-level vertical category tags, omit for all under this top-level tag", "items": { "properties": { "value": { "title": "Value", "description": "Sub-level vertical category tag id, obtained from the fetch_content_tag endpoint\n\nAPI references: `fetch_content_tag` = `GET /tikhub/douyin/billboard/fetch_content_tag` (operationId: `get_tikhub_douyin_billboard_fetch_content_tag`).", "type": [ "integer", "null" ] } }, "type": "object", "title": "BillboardTagChild" }, "type": [ "array", "null" ] } }, "type": "object", "title": "BillboardTag" }, "type": "array", "title": "Tags", "description": "Vertical tag filter; leave empty for all. Tag IDs are obtained from the fetch_content_tag endpoint.\n\nUsage: Vertical category tag filter, empty for all, tag ids come from the fetch_content_tag endpoint\n\nAPI references: `fetch_content_tag` = `GET /tikhub/douyin/billboard/fetch_content_tag` (operationId: `get_tikhub_douyin_billboard_fetch_content_tag`).", "example": [ { "children": [ { "value": 62808 }, { "value": 62804 } ], "value": 628 } ] } }, "type": "object", "title": "Body_fetch_hot_total_high_like_list_api_v1_douyin_billboard_fetch_hot_total_high_like_list_post" } } } }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:78aced00d3525d0f58f715614bf2ae41e0e925ac29520a2aac3c973a7e695b89" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-billboard-fetch_hot_total_high_like_list" } }, "/apis/v1/tikhub/douyin/billboard/fetch_hot_total_high_play_list": { "post": { "description": "Douyin (billboard).\n\n### Purpose:\n- Get the high completion rate list\n### Parameters:\n- page: Page number\n- page_size: Number of items per page\n- date_window: Time window in hours, one of 1/24/72/168 (last 1 hour / 1 day / 3 days / 7 days), default 24\n- keyword: Search keyword to filter the billboard, empty for all\n- tags: Vertical category tag filter, empty for all, tag ids come from the fetch_content_tag endpoint\n### Request Example:\n```json\n{\n \"page\": 1,\n \"page_size\": 10,\n \"date_window\": 24,\n \"keyword\": \"\",\n \"tags\": [\n {\"value\": 628, \"children\": [{\"value\": 62808}, {\"value\": 62804}]}\n ]\n}\n```\n### Return:\n- High completion rate list\n\nAPI references: `fetch_content_tag` = `GET /tikhub/douyin/billboard/fetch_content_tag` (operationId: `get_tikhub_douyin_billboard_fetch_content_tag`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_billboard_fetch_hot_total_high_play_list", "responses": { "200": { "description": "Successful Response\n\n### Return\n- High completion rate list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_hot_total_high_play_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "844703a8a0fb" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/billboard/fetch_hot_total_high_play_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_billboard_fetch_hot_total_high_play_list", "method": "POST", "path": "/apis/v1/tikhub/douyin/billboard/fetch_hot_total_high_play_list" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "page": { "type": "integer", "title": "Page", "description": "Page number", "default": 1 }, "page_size": { "type": "integer", "title": "Page Size", "description": "Items per page", "default": 10 }, "date_window": { "type": "integer", "title": "Date Window", "description": "Time window (hours): 1=last 1 hour, 24=last 1 day, 72=last 3 days, 168=last 7 days; default 24\n\nUsage: Time window in hours, one of 1/24/72/168 (last 1 hour / 1 day / 3 days / 7 days), default 24", "default": 24 }, "keyword": { "type": "string", "title": "Keyword", "description": "Search keyword for filtering the leaderboard; empty=all\n\nUsage: Search keyword to filter the billboard, empty for all", "default": "" }, "tags": { "items": { "properties": { "value": { "title": "Value", "description": "Top-level vertical category tag id, obtained from the fetch_content_tag endpoint\n\nAPI references: `fetch_content_tag` = `GET /tikhub/douyin/billboard/fetch_content_tag` (operationId: `get_tikhub_douyin_billboard_fetch_content_tag`).", "type": [ "integer", "null" ] }, "children": { "title": "Children", "description": "Sub-level vertical category tags, omit for all under this top-level tag", "items": { "properties": { "value": { "title": "Value", "description": "Sub-level vertical category tag id, obtained from the fetch_content_tag endpoint\n\nAPI references: `fetch_content_tag` = `GET /tikhub/douyin/billboard/fetch_content_tag` (operationId: `get_tikhub_douyin_billboard_fetch_content_tag`).", "type": [ "integer", "null" ] } }, "type": "object", "title": "BillboardTagChild" }, "type": [ "array", "null" ] } }, "type": "object", "title": "BillboardTag" }, "type": "array", "title": "Tags", "description": "Vertical tag filter; leave empty for all. Tag IDs are obtained from the fetch_content_tag endpoint.\n\nUsage: Vertical category tag filter, empty for all, tag ids come from the fetch_content_tag endpoint\n\nAPI references: `fetch_content_tag` = `GET /tikhub/douyin/billboard/fetch_content_tag` (operationId: `get_tikhub_douyin_billboard_fetch_content_tag`).", "example": [ { "children": [ { "value": 62808 }, { "value": 62804 } ], "value": 628 } ] } }, "type": "object", "title": "Body_fetch_hot_total_high_play_list_api_v1_douyin_billboard_fetch_hot_total_high_play_list_post" } } } }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:7e504ae10ccee80bb724c2c0277aa46633249c2c98459f82780acfe537417956" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-billboard-fetch_hot_total_high_play_list" } }, "/apis/v1/tikhub/douyin/billboard/fetch_hot_total_high_search_list": { "post": { "description": "Douyin (billboard).\n\n### Purpose\n- Get the search list with rising popularity\n\n### Parameters\n- page_num: Page number\n- page_size: Number of items per page\n- date_window: Time window in hours, one of 1/24/72/168 (last 1 hour / 1 day / 3 days / 7 days), default 24\n- keyword: Search keyword\n\n### Request Example\n```json\n{\n \"page_num\": 1,\n \"page_size\": 10,\n \"date_window\": 24,\n \"keyword\": \"Douyin\"\n}\n```\n\n### Return\n- Search list with rising popularity\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_billboard_fetch_hot_total_high_search_list", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Search list with rising popularity", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_hot_total_high_search_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "bdb980990cf1" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/billboard/fetch_hot_total_high_search_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_billboard_fetch_hot_total_high_search_list", "method": "POST", "path": "/apis/v1/tikhub/douyin/billboard/fetch_hot_total_high_search_list" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "page_num": { "type": "integer", "title": "Page Num", "description": "Page number", "default": 1 }, "page_size": { "type": "integer", "title": "Page Size", "description": "Items per page", "default": 10 }, "date_window": { "type": "integer", "title": "Date Window", "description": "Time window (hours): 1=last 1 hour, 24=last 1 day, 72=last 3 days, 168=last 7 days; default 24\n\nUsage: Time window in hours, one of 1/24/72/168 (last 1 hour / 1 day / 3 days / 7 days), default 24", "default": 24 }, "keyword": { "type": "string", "title": "Keyword", "description": "Search keyword", "default": "抖音" } }, "type": "object", "title": "Body_fetch_hot_total_high_search_list_api_v1_douyin_billboard_fetch_hot_total_high_search_list_post" } } } }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:885029bbbf8aef7354882a6c679c6596705dda381976d2bbe9d4268651fdfbd0" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-billboard-fetch_hot_total_high_search_list" } }, "/apis/v1/tikhub/douyin/billboard/fetch_hot_total_high_topic_list": { "post": { "description": "Douyin (billboard).\n\n### Purpose:\n- Get the topic list with rising popularity\n### Parameters:\n- page: Page number\n- page_size: Number of items per page\n- date_window: Time window in hours, one of 1/24/72/168 (last 1 hour / 1 day / 3 days / 7 days), default 24\n- keyword: Search keyword to filter the billboard, empty for all\n- tags: Vertical category tag filter, empty for all, tag ids come from the fetch_content_tag endpoint\n### Request Example:\n```json\n{\n \"page\": 1,\n \"page_size\": 10,\n \"date_window\": 24,\n \"keyword\": \"\",\n \"tags\": [\n {\"value\": 628, \"children\": [{\"value\": 62808}, {\"value\": 62804}]}\n ]\n}\n```\n### Return:\n- Topic list with rising popularity\n\nAPI references: `fetch_content_tag` = `GET /tikhub/douyin/billboard/fetch_content_tag` (operationId: `get_tikhub_douyin_billboard_fetch_content_tag`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_billboard_fetch_hot_total_high_topic_list", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Topic list with rising popularity", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_hot_total_high_topic_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "83a8b92b2c18" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/billboard/fetch_hot_total_high_topic_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_billboard_fetch_hot_total_high_topic_list", "method": "POST", "path": "/apis/v1/tikhub/douyin/billboard/fetch_hot_total_high_topic_list" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "page": { "type": "integer", "title": "Page", "description": "Page number", "default": 1 }, "page_size": { "type": "integer", "title": "Page Size", "description": "Items per page", "default": 10 }, "date_window": { "type": "integer", "title": "Date Window", "description": "Time window (hours): 1=last 1 hour, 24=last 1 day, 72=last 3 days, 168=last 7 days; default 24\n\nUsage: Time window in hours, one of 1/24/72/168 (last 1 hour / 1 day / 3 days / 7 days), default 24", "default": 24 }, "keyword": { "type": "string", "title": "Keyword", "description": "Search keyword for filtering the leaderboard; empty=all\n\nUsage: Search keyword to filter the billboard, empty for all", "default": "" }, "tags": { "items": { "properties": { "value": { "title": "Value", "description": "Top-level vertical category tag id, obtained from the fetch_content_tag endpoint\n\nAPI references: `fetch_content_tag` = `GET /tikhub/douyin/billboard/fetch_content_tag` (operationId: `get_tikhub_douyin_billboard_fetch_content_tag`).", "type": [ "integer", "null" ] }, "children": { "title": "Children", "description": "Sub-level vertical category tags, omit for all under this top-level tag", "items": { "properties": { "value": { "title": "Value", "description": "Sub-level vertical category tag id, obtained from the fetch_content_tag endpoint\n\nAPI references: `fetch_content_tag` = `GET /tikhub/douyin/billboard/fetch_content_tag` (operationId: `get_tikhub_douyin_billboard_fetch_content_tag`).", "type": [ "integer", "null" ] } }, "type": "object", "title": "BillboardTagChild" }, "type": [ "array", "null" ] } }, "type": "object", "title": "BillboardTag" }, "type": "array", "title": "Tags", "description": "Vertical tag filter; leave empty for all. Tag IDs are obtained from the fetch_content_tag endpoint.\n\nUsage: Vertical category tag filter, empty for all, tag ids come from the fetch_content_tag endpoint\n\nAPI references: `fetch_content_tag` = `GET /tikhub/douyin/billboard/fetch_content_tag` (operationId: `get_tikhub_douyin_billboard_fetch_content_tag`).", "example": [ { "children": [ { "value": 62808 }, { "value": 62804 } ], "value": 628 } ] } }, "type": "object", "title": "Body_fetch_hot_total_high_topic_list_api_v1_douyin_billboard_fetch_hot_total_high_topic_list_post" } } } }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:b0d7473b6655b538edfc0b40c04f54c3440273544171a797ab1a91a64b41fdb0" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-billboard-fetch_hot_total_high_topic_list" } }, "/apis/v1/tikhub/douyin/billboard/fetch_hot_total_hot_word_detail_list": { "get": { "description": "Douyin (billboard).\n\n### Purpose:\n- Get the details of content words\n### Parameters:\n- keyword: Search keyword\n- word_id: Content word id\n- query_day: Query date, format is YYYYMMDD\n### Return:\n- Details of content words\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_billboard_fetch_hot_total_hot_word_detail_list", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Details of content words", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_hot_total_hot_word_detail_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a018a748693b" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/billboard/fetch_hot_total_hot_word_detail_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_billboard_fetch_hot_total_hot_word_detail_list", "method": "GET", "path": "/apis/v1/tikhub/douyin/billboard/fetch_hot_total_hot_word_detail_list" }, "parameters": [ { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Search keyword", "title": "Keyword" }, "description": "Search keyword" }, { "name": "query_day", "in": "query", "required": true, "schema": { "type": "integer", "description": "Query date in YYYYMMDD format; must be today's date", "title": "Query Day" }, "description": "Query date in YYYYMMDD format; must be today's date", "example": 20250105 }, { "name": "word_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Content keyword ID", "title": "Word Id" }, "description": "Content keyword ID" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:c3111730099532108398414c73c410da3d304c317fdeaa0671bfcfe53b54eb9c" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-billboard-fetch_hot_total_hot_word_detail_list" } }, "/apis/v1/tikhub/douyin/billboard/fetch_hot_total_hot_word_list": { "post": { "description": "Douyin (billboard).\n\n### Purpose\n- Get the list of all content words\n\n### Parameters\n- page_num: Page number\n- page_size: Number of items per page\n- date_window: Time window in hours, one of 24/72/168 (last 1 day / 3 days / 7 days), default 24\n- keyword: Search keyword\n\n### Request Example\n```json\n{\n \"page_num\": 1,\n \"page_size\": 10,\n \"date_window\": 24,\n \"keyword\": \"Douyin\"\n}\n```\n\n### Return\n- List of all content words\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_billboard_fetch_hot_total_hot_word_list", "responses": { "200": { "description": "Successful Response\n\n### Return\n- List of all content words", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_hot_total_hot_word_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "c53a7413ee8a" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/billboard/fetch_hot_total_hot_word_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_billboard_fetch_hot_total_hot_word_list", "method": "POST", "path": "/apis/v1/tikhub/douyin/billboard/fetch_hot_total_hot_word_list" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "page_num": { "type": "integer", "title": "Page Num", "description": "Page number", "default": 1 }, "page_size": { "type": "integer", "title": "Page Size", "description": "Items per page", "default": 10 }, "date_window": { "type": "integer", "title": "Date Window", "description": "Time window (hours): 24=last 1 day, 72=last 3 days, 168=last 7 days; default 24\n\nUsage: Time window in hours, one of 24/72/168 (last 1 day / 3 days / 7 days), default 24", "default": 24 }, "keyword": { "type": "string", "title": "Keyword", "description": "Search keyword", "default": "抖音" } }, "type": "object", "title": "Body_fetch_hot_total_hot_word_list_api_v1_douyin_billboard_fetch_hot_total_hot_word_list_post" } } } }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:6476bae1f9c8a57b0823510a6334673feb4bfceecfe2bb827df0e61bf4e319ed" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-billboard-fetch_hot_total_hot_word_list" } }, "/apis/v1/tikhub/douyin/billboard/fetch_hot_total_list": { "get": { "description": "Douyin (billboard).\n\n### Purpose:\n- Get the total hot list\n### Parameters:\n- page: Page number\n- page_size: Number of items per page\n- type: Snapshot type snapshot view by time range view by time range.\n - Note: snapshot_time is valid when snapshot, start_date and end_date are valid when range\n- snapshot_time: Snapshot time format yyyyMMddHHmmss\n- start_date: Snapshot start time format yyyyMMdd\n- end_date: Snapshot end time format yyyyMMdd\n- sentence_tag: Hot category tag, get from hot list category, multiple categories separated by commas, empty for all\n- keyword: Hot search term\n### Return:\n- Total hot list\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_billboard_fetch_hot_total_list", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Total hot list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_hot_total_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "73413ccbf067" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/billboard/fetch_hot_total_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_billboard_fetch_hot_total_list", "method": "GET", "path": "/apis/v1/tikhub/douyin/billboard/fetch_hot_total_list" }, "parameters": [ { "name": "end_date", "in": "query", "required": false, "schema": { "type": "string", "description": "Snapshot end time, yyyyMMdd format", "default": "", "title": "End Date" }, "description": "Snapshot end time, yyyyMMdd format" }, { "name": "keyword", "in": "query", "required": false, "schema": { "type": "string", "description": "Hot search keyword", "default": "", "title": "Keyword" }, "description": "Hot search keyword" }, { "name": "page", "in": "query", "required": true, "schema": { "type": "integer", "description": "Page number", "title": "Page" }, "description": "Page number", "example": 1 }, { "name": "page_size", "in": "query", "required": true, "schema": { "type": "integer", "description": "Items per page", "title": "Page Size" }, "description": "Items per page", "example": 10 }, { "name": "sentence_tag", "in": "query", "required": false, "schema": { "type": "string", "description": "Hot-spot category tag; obtained from the hot-spot ranking categories; multiple values separated by commas; leave empty for all", "default": "", "title": "Sentence Tag" }, "description": "Hot-spot category tag; obtained from the hot-spot ranking categories; multiple values separated by commas; leave empty for all" }, { "name": "snapshot_time", "in": "query", "required": false, "schema": { "type": "string", "description": "Snapshot time, yyyyMMddHHmmss format", "default": "20250106151500", "title": "Snapshot Time" }, "description": "Snapshot time, yyyyMMddHHmmss format" }, { "name": "start_date", "in": "query", "required": false, "schema": { "type": "string", "description": "Snapshot start time, yyyyMMdd format", "default": "", "title": "Start Date" }, "description": "Snapshot start time, yyyyMMdd format" }, { "name": "type", "in": "query", "required": true, "schema": { "type": "string", "description": "Snapshot type: snapshot=view by moment, range=view by time range\n\nUsage: Snapshot type snapshot view by time range view by time range.\n - Note: snapshot_time is valid when snapshot, start_date and end_date are valid when range", "example": "snapshot", "title": "Type" }, "description": "Snapshot type: snapshot=view by moment, range=view by time range\n\nUsage: Snapshot type snapshot view by time range view by time range.\n - Note: snapshot_time is valid when snapshot, start_date and end_date are valid when range" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e18a974df7e69397a0e71eb386128f1779c8c276a03a6fde5ef98e9f2b549ec4" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/billboard/fetch_hot_total_list?page=1&page_size=10&type=snapshot' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-billboard-fetch_hot_total_list" } }, "/apis/v1/tikhub/douyin/billboard/fetch_hot_total_low_fan_list": { "post": { "description": "Douyin (billboard).\n\n### Purpose:\n- Get the low fan explosion list\n### Parameters:\n- page: Page number\n- page_size: Number of items per page\n- date_window: Time window in hours, one of 1/24/72/168 (last 1 hour / 1 day / 3 days / 7 days), default 24\n- keyword: Search keyword to filter the billboard, empty for all\n- tags: Vertical category tag filter, empty for all, tag ids come from the fetch_content_tag endpoint\n### Request Example:\n```json\n{\n \"page\": 1,\n \"page_size\": 10,\n \"date_window\": 24,\n \"keyword\": \"\",\n \"tags\": [\n {\"value\": 628, \"children\": [{\"value\": 62808}, {\"value\": 62804}]}\n ]\n}\n```\n### Return:\n- Low fan explosion list\n\nAPI references: `fetch_content_tag` = `GET /tikhub/douyin/billboard/fetch_content_tag` (operationId: `get_tikhub_douyin_billboard_fetch_content_tag`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_billboard_fetch_hot_total_low_fan_list", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Low fan explosion list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_hot_total_low_fan_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "5e2308c9a65e" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/billboard/fetch_hot_total_low_fan_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_billboard_fetch_hot_total_low_fan_list", "method": "POST", "path": "/apis/v1/tikhub/douyin/billboard/fetch_hot_total_low_fan_list" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "page": { "type": "integer", "title": "Page", "description": "Page number", "default": 1 }, "page_size": { "type": "integer", "title": "Page Size", "description": "Items per page", "default": 10 }, "date_window": { "type": "integer", "title": "Date Window", "description": "Time window (hours): 1=last 1 hour, 24=last 1 day, 72=last 3 days, 168=last 7 days; default 24\n\nUsage: Time window in hours, one of 1/24/72/168 (last 1 hour / 1 day / 3 days / 7 days), default 24", "default": 24 }, "keyword": { "type": "string", "title": "Keyword", "description": "Search keyword for filtering the leaderboard; empty=all\n\nUsage: Search keyword to filter the billboard, empty for all", "default": "" }, "tags": { "items": { "properties": { "value": { "title": "Value", "description": "Top-level vertical category tag id, obtained from the fetch_content_tag endpoint\n\nAPI references: `fetch_content_tag` = `GET /tikhub/douyin/billboard/fetch_content_tag` (operationId: `get_tikhub_douyin_billboard_fetch_content_tag`).", "type": [ "integer", "null" ] }, "children": { "title": "Children", "description": "Sub-level vertical category tags, omit for all under this top-level tag", "items": { "properties": { "value": { "title": "Value", "description": "Sub-level vertical category tag id, obtained from the fetch_content_tag endpoint\n\nAPI references: `fetch_content_tag` = `GET /tikhub/douyin/billboard/fetch_content_tag` (operationId: `get_tikhub_douyin_billboard_fetch_content_tag`).", "type": [ "integer", "null" ] } }, "type": "object", "title": "BillboardTagChild" }, "type": [ "array", "null" ] } }, "type": "object", "title": "BillboardTag" }, "type": "array", "title": "Tags", "description": "Vertical tag filter; leave empty for all. Tag IDs are obtained from the fetch_content_tag endpoint.\n\nUsage: Vertical category tag filter, empty for all, tag ids come from the fetch_content_tag endpoint\n\nAPI references: `fetch_content_tag` = `GET /tikhub/douyin/billboard/fetch_content_tag` (operationId: `get_tikhub_douyin_billboard_fetch_content_tag`).", "example": [ { "children": [ { "value": 62808 }, { "value": 62804 } ], "value": 628 } ] } }, "type": "object", "title": "Body_fetch_hot_total_low_fan_list_api_v1_douyin_billboard_fetch_hot_total_low_fan_list_post" } } } }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:fff794af35e668dbec34608ecffd1d4aa6fadcbfafe0a292145b73a41eeed19b" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-billboard-fetch_hot_total_low_fan_list" } }, "/apis/v1/tikhub/douyin/billboard/fetch_hot_total_search_list": { "post": { "description": "Douyin (billboard).\n\n### Purpose\n- Get the search list\n\n### Parameters\n- page_num: Page number\n- page_size: Number of items per page\n- date_window: Time window in hours, one of 1/24/72/168 (last 1 hour / 1 day / 3 days / 7 days), default 24\n- keyword: Search keyword\n\n### Request Example\n```json\n{\n \"page_num\": 1,\n \"page_size\": 10,\n \"date_window\": 24,\n \"keyword\": \"Douyin\"\n}\n```\n\n### Return\n- Search list\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_billboard_fetch_hot_total_search_list", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Search list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_hot_total_search_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "b0192a353420" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/billboard/fetch_hot_total_search_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_billboard_fetch_hot_total_search_list", "method": "POST", "path": "/apis/v1/tikhub/douyin/billboard/fetch_hot_total_search_list" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "page_num": { "type": "integer", "title": "Page Num", "description": "Page number", "default": 1 }, "page_size": { "type": "integer", "title": "Page Size", "description": "Items per page", "default": 10 }, "date_window": { "type": "integer", "title": "Date Window", "description": "Time window (hours): 1=last 1 hour, 24=last 1 day, 72=last 3 days, 168=last 7 days; default 24\n\nUsage: Time window in hours, one of 1/24/72/168 (last 1 hour / 1 day / 3 days / 7 days), default 24", "default": 24 }, "keyword": { "type": "string", "title": "Keyword", "description": "Search keyword", "default": "抖音" } }, "type": "object", "title": "Body_fetch_hot_total_search_list_api_v1_douyin_billboard_fetch_hot_total_search_list_post" } } } }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:71b3b357d0b715512a2a04bff28f1caa2b4d3719930cf4b09c10e36401f06f76" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-billboard-fetch_hot_total_search_list" } }, "/apis/v1/tikhub/douyin/billboard/fetch_hot_total_topic_list": { "post": { "description": "Douyin (billboard).\n\n### Purpose:\n- Get the topic list\n### Parameters:\n- page: Page number\n- page_size: Number of items per page\n- date_window: Time window in hours, one of 1/24/72/168 (last 1 hour / 1 day / 3 days / 7 days), default 24\n- keyword: Search keyword to filter the billboard, empty for all\n- tags: Vertical category tag filter, empty for all, tag ids come from the fetch_content_tag endpoint\n### Request Example:\n```json\n{\n \"page\": 1,\n \"page_size\": 10,\n \"date_window\": 24,\n \"keyword\": \"\",\n \"tags\": [\n {\"value\": 628, \"children\": [{\"value\": 62808}, {\"value\": 62804}]}\n ]\n}\n```\n### Return:\n- Topic list\n\nAPI references: `fetch_content_tag` = `GET /tikhub/douyin/billboard/fetch_content_tag` (operationId: `get_tikhub_douyin_billboard_fetch_content_tag`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_billboard_fetch_hot_total_topic_list", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Topic list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_hot_total_topic_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "44c4e09fe751" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/billboard/fetch_hot_total_topic_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_billboard_fetch_hot_total_topic_list", "method": "POST", "path": "/apis/v1/tikhub/douyin/billboard/fetch_hot_total_topic_list" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "page": { "type": "integer", "title": "Page", "description": "Page number", "default": 1 }, "page_size": { "type": "integer", "title": "Page Size", "description": "Items per page", "default": 10 }, "date_window": { "type": "integer", "title": "Date Window", "description": "Time window (hours): 1=last 1 hour, 24=last 1 day, 72=last 3 days, 168=last 7 days; default 24\n\nUsage: Time window in hours, one of 1/24/72/168 (last 1 hour / 1 day / 3 days / 7 days), default 24", "default": 24 }, "keyword": { "type": "string", "title": "Keyword", "description": "Search keyword for filtering the leaderboard; empty=all\n\nUsage: Search keyword to filter the billboard, empty for all", "default": "" }, "tags": { "items": { "properties": { "value": { "title": "Value", "description": "Top-level vertical category tag id, obtained from the fetch_content_tag endpoint\n\nAPI references: `fetch_content_tag` = `GET /tikhub/douyin/billboard/fetch_content_tag` (operationId: `get_tikhub_douyin_billboard_fetch_content_tag`).", "type": [ "integer", "null" ] }, "children": { "title": "Children", "description": "Sub-level vertical category tags, omit for all under this top-level tag", "items": { "properties": { "value": { "title": "Value", "description": "Sub-level vertical category tag id, obtained from the fetch_content_tag endpoint\n\nAPI references: `fetch_content_tag` = `GET /tikhub/douyin/billboard/fetch_content_tag` (operationId: `get_tikhub_douyin_billboard_fetch_content_tag`).", "type": [ "integer", "null" ] } }, "type": "object", "title": "BillboardTagChild" }, "type": [ "array", "null" ] } }, "type": "object", "title": "BillboardTag" }, "type": "array", "title": "Tags", "description": "Vertical tag filter; leave empty for all. Tag IDs are obtained from the fetch_content_tag endpoint.\n\nUsage: Vertical category tag filter, empty for all, tag ids come from the fetch_content_tag endpoint\n\nAPI references: `fetch_content_tag` = `GET /tikhub/douyin/billboard/fetch_content_tag` (operationId: `get_tikhub_douyin_billboard_fetch_content_tag`).", "example": [ { "children": [ { "value": 62808 }, { "value": 62804 } ], "value": 628 } ] } }, "type": "object", "title": "Body_fetch_hot_total_topic_list_api_v1_douyin_billboard_fetch_hot_total_topic_list_post" } } } }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:ae3629a9a6169e5bd1ea875f7325cd01679b51d5a571dc13652c80f4ba0ff026" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-billboard-fetch_hot_total_topic_list" } }, "/apis/v1/tikhub/douyin/billboard/fetch_hot_total_video_list": { "post": { "description": "Douyin (billboard).\n\n### Purpose:\n- Get the video list\n### Parameters:\n- page: Page number\n- page_size: Number of items per page\n- date_window: Time window in hours, one of 1/24/72/168 (last 1 hour / 1 day / 3 days / 7 days), default 24\n- sub_type: List category, 1001 Video total list 1002 Low fan explosion 1003 High completion rate 1004 High fan growth rate 1005 High like rate\n- keyword: Search keyword to filter the billboard, empty for all\n- tags: Vertical category tag filter, empty for all, tag ids come from the fetch_content_tag endpoint\n### Request Example:\n```json\n{\n \"page\": 1,\n \"page_size\": 10,\n \"date_window\": 24,\n \"sub_type\": 1001,\n \"keyword\": \"\",\n \"tags\": [\n {\"value\": 628, \"children\": [{\"value\": 62808}, {\"value\": 62804}]}\n ]\n}\n```\n### Return:\n- Video list\n\nAPI references: `fetch_content_tag` = `GET /tikhub/douyin/billboard/fetch_content_tag` (operationId: `get_tikhub_douyin_billboard_fetch_content_tag`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_billboard_fetch_hot_total_video_list", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Video list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_hot_total_video_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "584a4fdb0fa7" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/billboard/fetch_hot_total_video_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_billboard_fetch_hot_total_video_list", "method": "POST", "path": "/apis/v1/tikhub/douyin/billboard/fetch_hot_total_video_list" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "page": { "type": "integer", "title": "Page", "description": "Page number, default 1", "default": 1 }, "page_size": { "type": "integer", "title": "Page Size", "description": "Items per page, default 10", "default": 10 }, "date_window": { "type": "integer", "title": "Date Window", "description": "Time window (hours): 1=last 1 hour, 24=last 1 day, 72=last 3 days, 168=last 7 days; default 24\n\nUsage: Time window in hours, one of 1/24/72/168 (last 1 hour / 1 day / 3 days / 7 days), default 24", "default": 24 }, "sub_type": { "type": "integer", "title": "Sub Type", "description": "Ranking category: 1001 Overall Video, 1002 Low-follower Viral, 1003 High Completion Rate, 1004 High Follower Growth Rate, 1005 High Like Rate", "default": 1001 }, "keyword": { "type": "string", "title": "Keyword", "description": "Search keyword for filtering the leaderboard; empty=all\n\nUsage: Search keyword to filter the billboard, empty for all", "default": "" }, "tags": { "items": { "properties": { "value": { "title": "Value", "description": "Top-level vertical category tag id, obtained from the fetch_content_tag endpoint\n\nAPI references: `fetch_content_tag` = `GET /tikhub/douyin/billboard/fetch_content_tag` (operationId: `get_tikhub_douyin_billboard_fetch_content_tag`).", "type": [ "integer", "null" ] }, "children": { "title": "Children", "description": "Sub-level vertical category tags, omit for all under this top-level tag", "items": { "properties": { "value": { "title": "Value", "description": "Sub-level vertical category tag id, obtained from the fetch_content_tag endpoint\n\nAPI references: `fetch_content_tag` = `GET /tikhub/douyin/billboard/fetch_content_tag` (operationId: `get_tikhub_douyin_billboard_fetch_content_tag`).", "type": [ "integer", "null" ] } }, "type": "object", "title": "BillboardTagChild" }, "type": [ "array", "null" ] } }, "type": "object", "title": "BillboardTag" }, "type": "array", "title": "Tags", "description": "Vertical tag filter; leave empty for all. Tag IDs are obtained from the fetch_content_tag endpoint.\n\nUsage: Vertical category tag filter, empty for all, tag ids come from the fetch_content_tag endpoint\n\nAPI references: `fetch_content_tag` = `GET /tikhub/douyin/billboard/fetch_content_tag` (operationId: `get_tikhub_douyin_billboard_fetch_content_tag`).", "example": [ { "children": [ { "value": 62808 }, { "value": 62804 } ], "value": 628 } ] } }, "type": "object", "title": "Body_fetch_hot_total_video_list_api_v1_douyin_billboard_fetch_hot_total_video_list_post" } } } }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:f97f25757ddb810d32a471da4bdc3fc73a86f1901f37cf06f4a45edd9b92a39d" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-billboard-fetch_hot_total_video_list" } }, "/apis/v1/tikhub/douyin/billboard/fetch_hot_user_portrait_list": { "get": { "description": "Douyin (billboard).\n\n### Purpose:\n- Get the work like audience portrait\n### Parameters:\n- aweme_id: Work id\n- option: Option\n - 1 Mobile price\n - 2 Gender distribution\n - 3 Age distribution\n - 4 Regional distribution - province\n - 5 Regional distribution - city\n - 6 City level\n - 7 Mobile brand distribution\n### Return:\n- Work like audience portrait\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_billboard_fetch_hot_user_portrait_list", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Work like audience portrait", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_hot_user_portrait_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "4ab6affb0fb7" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/billboard/fetch_hot_user_portrait_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_billboard_fetch_hot_user_portrait_list", "method": "GET", "path": "/apis/v1/tikhub/douyin/billboard/fetch_hot_user_portrait_list" }, "parameters": [ { "name": "aweme_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Post ID", "title": "Aweme Id" }, "description": "Post ID", "example": "7456035425539329340" }, { "name": "option", "in": "query", "required": false, "schema": { "type": "integer", "description": "Options: 1=Phone price distribution, 2=Gender distribution, 3=Age distribution, 4=Regional distribution by province, 5=Regional distribution by city, 6=City tier, 7=Phone brand distribution", "example": 1, "default": 4, "title": "Option" }, "description": "Options: 1=Phone price distribution, 2=Gender distribution, 3=Age distribution, 4=Regional distribution by province, 5=Regional distribution by city, 6=City tier, 7=Phone brand distribution" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:c0fb5df4d18a97780bb697f047421cebff7b063a7605965d2191c523f98e236b" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/billboard/fetch_hot_user_portrait_list?aweme_id=7456035425539329340' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-billboard-fetch_hot_user_portrait_list" } }, "/apis/v1/tikhub/douyin/creator/fetch_creator_activity_detail": { "get": { "description": "Douyin (creator).\n\n### Purpose:\n- Get Douyin creator activity detail data\n### Parameters:\n- activity_id: Activity ID (obtained from activity list interface)\n### Return:\n- Creator activity detail data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_creator_fetch_creator_activity_detail", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Creator activity detail data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_creator_activity_detail", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "32eeb4805626" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/creator/fetch_creator_activity_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_creator_fetch_creator_activity_detail", "method": "GET", "path": "/apis/v1/tikhub/douyin/creator/fetch_creator_activity_detail" }, "parameters": [ { "name": "activity_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Activity ID (obtained from activity list interface)", "title": "Activity Id" }, "description": "Activity ID (obtained from activity list interface)", "example": "7545335931785450534" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:14e17c58c37ee35280d6c23b383051ee3421d86d0050a1c0ef3eedcd1499d141" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/creator/fetch_creator_activity_detail?activity_id=7545335931785450534' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-creator-fetch_creator_activity_detail" } }, "/apis/v1/tikhub/douyin/creator/fetch_creator_activity_list": { "get": { "description": "Douyin (creator).\n\n### Purpose:\n- Get Douyin creator activity list data\n### Parameters:\n- start_time: Start timestamp\n- end_time: End timestamp\n### Return:\n- Creator activity list data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_creator_fetch_creator_activity_list", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Creator activity list data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_creator_activity_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a362cca49c57" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/creator/fetch_creator_activity_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_creator_fetch_creator_activity_list", "method": "GET", "path": "/apis/v1/tikhub/douyin/creator/fetch_creator_activity_list" }, "parameters": [ { "name": "end_time", "in": "query", "required": true, "schema": { "type": "integer", "description": "End timestamp", "title": "End Time" }, "description": "End timestamp", "example": 1759247999 }, { "name": "start_time", "in": "query", "required": true, "schema": { "type": "integer", "description": "Start timestamp", "title": "Start Time" }, "description": "Start timestamp", "example": 1756656000 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:7088569e1127feef1492390aafc0740474d9d1d22c4fce5bf833f24df476cd33" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/creator/fetch_creator_activity_list?end_time=1759247999&start_time=1756656000' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-creator-fetch_creator_activity_list" } }, "/apis/v1/tikhub/douyin/creator/fetch_creator_content_category": { "get": { "description": "Douyin (creator).\n\n### Purpose:\n- Get Douyin creator platform content creation category list\n### Parameters:\n- No additional parameters required\n### Return:\n- Content creation category data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_creator_fetch_creator_content_category", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Content creation category data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_creator_content_category", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "bed3a3de86cb" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/creator/fetch_creator_content_category", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_creator_fetch_creator_content_category", "method": "GET", "path": "/apis/v1/tikhub/douyin/creator/fetch_creator_content_category" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:18cb54e0a7ddd0b53ceace0f66cd00c94a5fb9b3df32c32a3923555d85ddc12a" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-creator-fetch_creator_content_category" } }, "/apis/v1/tikhub/douyin/creator/fetch_creator_content_course": { "get": { "description": "Douyin (creator).\n\n### Purpose:\n- Get Douyin creator platform content creation courses for specified category\n### Parameters:\n- category_id: Category ID (for more category IDs, please refer to the content creation category interface)\n Common category ID examples:\n - 184: Video Creation\n - 185: Live Streaming Creation\n - 186: Image & Text Creation\n - 188: Food Video Creation\n - 180: Content Creation Basics\n- order: Order type (1=recommended order, 2=most popular, 3=latest upload)\n- limit: Items per page (recommended 24, range 1-100)\n- offset: Offset (starting position)\n### Return:\n- Content creation course data for specified category\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_creator_fetch_creator_content_course", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Content creation course data for specified category", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_creator_content_course", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "3b86c75e2741" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/creator/fetch_creator_content_course", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_creator_fetch_creator_content_course", "method": "GET", "path": "/apis/v1/tikhub/douyin/creator/fetch_creator_content_course" }, "parameters": [ { "name": "category_id", "in": "query", "required": true, "schema": { "type": "integer", "description": "Category ID (for more category IDs, please refer to the content creation category interface)\n Common category ID examples:\n - 184: Video Creation\n - 185: Live Streaming Creation\n - 186: Image & Text Creation\n - 188: Food Video Creation\n - 180: Content Creation Basics", "title": "Category Id" }, "description": "Category ID (for more category IDs, please refer to the content creation category interface)\n Common category ID examples:\n - 184: Video Creation\n - 185: Live Streaming Creation\n - 186: Image & Text Creation\n - 188: Food Video Creation\n - 180: Content Creation Basics", "example": 180 }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 1, "description": "Items per page (recommended 24, range 1-100)", "default": 24, "title": "Limit" }, "description": "Items per page (recommended 24, range 1-100)", "example": 24 }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "description": "Offset (starting position)", "default": 0, "title": "Offset" }, "description": "Offset (starting position)", "example": 0 }, { "name": "order", "in": "query", "required": false, "schema": { "type": "integer", "description": "Order type: 1=Recommended, 2=Most popular, 3=Latest upload", "default": 1, "title": "Order" }, "description": "Order type: 1=Recommended, 2=Most popular, 3=Latest upload", "example": 1 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:124a68ca2749cb2389f3f65ed4ff07c93a136c864a87f3c8d7e80690023f2c8f" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/creator/fetch_creator_content_course?category_id=180&limit=24&offset=0&order=1' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-creator-fetch_creator_content_course" } }, "/apis/v1/tikhub/douyin/creator/fetch_creator_hot_challenge_billboard": { "get": { "description": "Douyin (creator).\n\n### Purpose:\n- Get Douyin creator platform hot challenge billboard data\n### Return:\n- Hot challenge billboard data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_creator_fetch_creator_hot_challenge_billboard", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Hot challenge billboard data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_creator_hot_challenge_billboard", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "d0f639ef60c4" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/creator/fetch_creator_hot_challenge_billboard", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_creator_fetch_creator_hot_challenge_billboard", "method": "GET", "path": "/apis/v1/tikhub/douyin/creator/fetch_creator_hot_challenge_billboard" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:592a794be6aa938177d30d4a27f7d3affadfe6ef9af638b1444938b1ba9d2ed1" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-creator-fetch_creator_hot_challenge_billboard" } }, "/apis/v1/tikhub/douyin/creator/fetch_creator_hot_course": { "get": { "description": "Douyin (creator).\n\n### Purpose:\n- Get Douyin creator platform hot course data or selected topic courses\n### Parameters:\n- order: Order type (1=recommended order, 2=most popular, 3=latest upload)\n- limit: Items per page (recommended 24, range 1-100)\n- offset: Offset (starting position)\n- category_id: Selected topic category ID (empty for hot courses, specific ID for selected topics)\n Available values:\n - 6976547830546582816: Knowledge Category\n - 6976547923849006336: Life Category\n - 6976547940311633165: Entertainment Category\n - 6976547972108635404: Food Category\n - 6980288134957272352: Positive Energy\n - 6980288181744766219: Gaming Category\n - 6980288219548011776: General\n### Return:\n- Hot course data or selected topic course data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_creator_fetch_creator_hot_course", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Hot course data or selected topic course data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_creator_hot_course", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "250fa051fbca" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/creator/fetch_creator_hot_course", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_creator_fetch_creator_hot_course", "method": "GET", "path": "/apis/v1/tikhub/douyin/creator/fetch_creator_hot_course" }, "parameters": [ { "name": "category_id", "in": "query", "required": false, "schema": { "description": "Selected topic category ID - omit for popular courses, provide to filter by selected topic\n Available values:\n 6976547830546582816=Knowledge, 6976547923849006336=Lifestyle, 6976547940311633165=Entertainment,\n 6976547972108635404=Food, 6980288134957272352=Positivity, 6980288181744766219=Gaming,\n 6980288219548011776=General", "title": "Category Id", "type": [ "string", "null" ] }, "description": "Selected topic category ID - omit for popular courses, provide to filter by selected topic\n Available values:\n 6976547830546582816=Knowledge, 6976547923849006336=Lifestyle, 6976547940311633165=Entertainment,\n 6976547972108635404=Food, 6980288134957272352=Positivity, 6980288181744766219=Gaming,\n 6980288219548011776=General" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 1, "description": "Items per page (recommended 24, range 1-100)", "default": 24, "title": "Limit" }, "description": "Items per page (recommended 24, range 1-100)", "example": 24 }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "description": "Offset", "default": 0, "title": "Offset" }, "description": "Offset", "example": 0 }, { "name": "order", "in": "query", "required": false, "schema": { "type": "integer", "description": "Order type: 1=Recommended, 2=Most popular, 3=Latest upload", "default": 1, "title": "Order" }, "description": "Order type: 1=Recommended, 2=Most popular, 3=Latest upload", "example": 1 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e12322470c41639ac855fbeb98216024012fa75c523cd58786857cb77195f016" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-creator-fetch_creator_hot_course" } }, "/apis/v1/tikhub/douyin/creator/fetch_creator_hot_music_billboard": { "get": { "description": "Douyin (creator).\n\n### Purpose:\n- Get Douyin creator platform hot music billboard data\n### Parameters:\n- billboard_tag: Billboard tag, 0=all, other values can be obtained through config interface\n- order_key: Order key (1=highest views, 2=most likes, 4=highest popularity, 5=most submissions)\n- time_filter: Time filter (1=24 hours, 2=7 days, 3=30 days)\n### Return:\n- Hot music billboard data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_creator_fetch_creator_hot_music_billboard", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Hot music billboard data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_creator_hot_music_billboard", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a160b76cfb74" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/creator/fetch_creator_hot_music_billboard", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_creator_fetch_creator_hot_music_billboard", "method": "GET", "path": "/apis/v1/tikhub/douyin/creator/fetch_creator_hot_music_billboard" }, "parameters": [ { "name": "billboard_tag", "in": "query", "required": false, "schema": { "type": "integer", "description": "Billboard tag (0=all; specific category values can be obtained via the config endpoint)\n\nUsage: Billboard tag, 0=all, other values can be obtained through config interface", "default": 0, "title": "Billboard Tag" }, "description": "Billboard tag (0=all; specific category values can be obtained via the config endpoint)\n\nUsage: Billboard tag, 0=all, other values can be obtained through config interface", "example": 0 }, { "name": "order_key", "in": "query", "required": false, "schema": { "type": "integer", "description": "Order key: 1=highest views, 2=most likes, 4=highest popularity, 5=most submissions", "default": 1, "title": "Order Key" }, "description": "Order key: 1=highest views, 2=most likes, 4=highest popularity, 5=most submissions", "example": 1 }, { "name": "time_filter", "in": "query", "required": false, "schema": { "type": "integer", "description": "Time filter: 1=24 hours, 2=7 days, 3=30 days", "default": 1, "title": "Time Filter" }, "description": "Time filter: 1=24 hours, 2=7 days, 3=30 days", "example": 1 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:40551abdf741f02e55060b00c1cf32fddc610cf822735a7738a8612c48bdfa5e" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-creator-fetch_creator_hot_music_billboard" } }, "/apis/v1/tikhub/douyin/creator/fetch_creator_hot_props_billboard": { "get": { "description": "Douyin (creator).\n\n### Purpose:\n- Get Douyin creator hot props billboard data\n### Parameters:\n- billboard_tag: Billboard tag, 0=all, other values can be obtained through config interface\n - 0: All\n - 333: Food\n - 334: Travel\n - 299: Lifestyle\n - 335: Automotive\n - 336: Technology\n - 302: Gaming\n - 296: Anime\n - 337: Entertainment\n - 311: Celebrity\n - 298: Sports\n - 300: Culture & Education\n - 301: Campus\n - 297: Government\n - 305: Fashion\n - 306: Talent Show\n - 669: Finance\n - 314: Random\n - 307: Animals & Plants\n - 309: Graphics & Text\n - 308: Drama\n - 315: Parenting\n - 718: Agriculture\n - 310: Creative\n - 312: Outdoor\n - 926: Public Welfare\n- order_key: Order key\n - 1: Highest views\n - 5: Most submissions\n - 6: Highest exposure\n - 7: Most favorites\n- time_filter: Time filter\n - 1: 24 hours\n - 2: 7 days\n - 3: 30 days\n### Return:\n- Creator hot props billboard data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_creator_fetch_creator_hot_props_billboard", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Creator hot props billboard data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_creator_hot_props_billboard", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "72c20730691f" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/creator/fetch_creator_hot_props_billboard", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_creator_fetch_creator_hot_props_billboard", "method": "GET", "path": "/apis/v1/tikhub/douyin/creator/fetch_creator_hot_props_billboard" }, "parameters": [ { "name": "billboard_tag", "in": "query", "required": false, "schema": { "type": "integer", "description": "Billboard tag, 0=all, other values can be obtained through config interface\n - 0: All\n - 333: Food\n - 334: Travel\n - 299: Lifestyle\n - 335: Automotive\n - 336: Technology\n - 302: Gaming\n - 296: Anime\n - 337: Entertainment\n - 311: Celebrity\n - 298: Sports\n - 300: Culture & Education\n - 301: Campus\n - 297: Government\n - 305: Fashion\n - 306: Talent Show\n - 669: Finance\n - 314: Random\n - 307: Animals & Plants\n - 309: Graphics & Text\n - 308: Drama\n - 315: Parenting\n - 718: Agriculture\n - 310: Creative\n - 312: Outdoor\n - 926: Public Welfare", "default": 0, "title": "Billboard Tag" }, "description": "Billboard tag, 0=all, other values can be obtained through config interface\n - 0: All\n - 333: Food\n - 334: Travel\n - 299: Lifestyle\n - 335: Automotive\n - 336: Technology\n - 302: Gaming\n - 296: Anime\n - 337: Entertainment\n - 311: Celebrity\n - 298: Sports\n - 300: Culture & Education\n - 301: Campus\n - 297: Government\n - 305: Fashion\n - 306: Talent Show\n - 669: Finance\n - 314: Random\n - 307: Animals & Plants\n - 309: Graphics & Text\n - 308: Drama\n - 315: Parenting\n - 718: Agriculture\n - 310: Creative\n - 312: Outdoor\n - 926: Public Welfare" }, { "name": "order_key", "in": "query", "required": false, "schema": { "type": "integer", "description": "Order key: 1=highest views, 5=most submissions, 6=highest exposure, 7=most favorites", "default": 1, "title": "Order Key" }, "description": "Order key: 1=highest views, 5=most submissions, 6=highest exposure, 7=most favorites" }, { "name": "time_filter", "in": "query", "required": false, "schema": { "type": "integer", "description": "Time filter: 1=24 hours, 2=7 days, 3=30 days", "default": 1, "title": "Time Filter" }, "description": "Time filter: 1=24 hours, 2=7 days, 3=30 days" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:f48af453718d7738d5b412c5653695ee424d422f16b79c33a368eddb99fffa53" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-creator-fetch_creator_hot_props_billboard" } }, "/apis/v1/tikhub/douyin/creator/fetch_creator_hot_spot_billboard": { "get": { "description": "Douyin (creator).\n\n### Purpose:\n- Get Douyin creator hot spot billboard data\n### Parameters:\n- billboard_tag: Hot spot tag - multiple tags separated by comma\n Available values:\n - Platform Features: 1004,1000,1002,1003,1001\n - Topic Interaction: 20001,20006,20000,20003,20005,20002,20\n - Entertainment: 2007,2000,2011,2012,2009,2010,2004,2005,2003,2008,2001,2002,2006\n - Society: 4005,4006,4007,4003,4004,4000\n - Anime: 13000\n - Transportation: 23000\n - Parenting: 19000\n - Sports: 5002,5000,5001\n - Military: 21000\n - Drama: 18000\n - Animals & Pets: 8000\n - Weather: 22001,22002\n - Talent Show: 17000\n - Culture & Education: 14000\n - Travel: 10000\n - Fashion: 16000\n - Politics: 3000,3001,3002\n - Campus: 15000\n - Automotive: 11000\n - Gaming: 12000,12001\n - Technology: 6000\n - Food: 9000\n - Finance: 7000\n- hot_search_type: Hot search type\n - 1: Hot Spot Overall Ranking\n - 2: Local Hot Spot Ranking\n - 3: Rising Hot Spot Ranking\n- city_code: City code - required when hot_search_type=2\n### Return:\n- Creator hot spot billboard data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_creator_fetch_creator_hot_spot_billboard", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Creator hot spot billboard data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_creator_hot_spot_billboard", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "53d0d20c153d" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/creator/fetch_creator_hot_spot_billboard", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_creator_fetch_creator_hot_spot_billboard", "method": "GET", "path": "/apis/v1/tikhub/douyin/creator/fetch_creator_hot_spot_billboard" }, "parameters": [ { "name": "billboard_tag", "in": "query", "required": false, "schema": { "type": "string", "description": "Hot spot tag - multiple tags separated by comma, like '1004,1000,1002'\n\nUsage: Hot spot tag - multiple tags separated by comma\n Available values:\n - Platform Features: 1004,1000,1002,1003,1001\n - Topic Interaction: 20001,20006,20000,20003,20005,20002,20\n - Entertainment: 2007,2000,2011,2012,2009,2010,2004,2005,2003,2008,2001,2002,2006\n - Society: 4005,4006,4007,4003,4004,4000\n - Anime: 13000\n - Transportation: 23000\n - Parenting: 19000\n - Sports: 5002,5000,5001\n - Military: 21000\n - Drama: 18000\n - Animals & Pets: 8000\n - Weather: 22001,22002\n - Talent Show: 17000\n - Culture & Education: 14000\n - Travel: 10000\n - Fashion: 16000\n - Politics: 3000,3001,3002\n - Campus: 15000\n - Automotive: 11000\n - Gaming: 12000,12001\n - Technology: 6000\n - Food: 9000\n - Finance: 7000", "default": "0", "title": "Billboard Tag" }, "description": "Hot spot tag - multiple tags separated by comma, like '1004,1000,1002'\n\nUsage: Hot spot tag - multiple tags separated by comma\n Available values:\n - Platform Features: 1004,1000,1002,1003,1001\n - Topic Interaction: 20001,20006,20000,20003,20005,20002,20\n - Entertainment: 2007,2000,2011,2012,2009,2010,2004,2005,2003,2008,2001,2002,2006\n - Society: 4005,4006,4007,4003,4004,4000\n - Anime: 13000\n - Transportation: 23000\n - Parenting: 19000\n - Sports: 5002,5000,5001\n - Military: 21000\n - Drama: 18000\n - Animals & Pets: 8000\n - Weather: 22001,22002\n - Talent Show: 17000\n - Culture & Education: 14000\n - Travel: 10000\n - Fashion: 16000\n - Politics: 3000,3001,3002\n - Campus: 15000\n - Automotive: 11000\n - Gaming: 12000,12001\n - Technology: 6000\n - Food: 9000\n - Finance: 7000" }, { "name": "city_code", "in": "query", "required": false, "schema": { "description": "City code - required when hot_search_type=2", "title": "City Code", "type": [ "string", "null" ] }, "description": "City code - required when hot_search_type=2" }, { "name": "hot_search_type", "in": "query", "required": false, "schema": { "type": "integer", "description": "Hot search type: 1=Overall ranking, 2=Local ranking, 3=Rising ranking\n\nUsage: Hot search type\n - 1: Hot Spot Overall Ranking\n - 2: Local Hot Spot Ranking\n - 3: Rising Hot Spot Ranking", "default": 1, "title": "Hot Search Type" }, "description": "Hot search type: 1=Overall ranking, 2=Local ranking, 3=Rising ranking\n\nUsage: Hot search type\n - 1: Hot Spot Overall Ranking\n - 2: Local Hot Spot Ranking\n - 3: Rising Hot Spot Ranking" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:419e85977b7e1cc6a0958e790044af57d3c26b5edfe752265c61d6ae0b3ea44f" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-creator-fetch_creator_hot_spot_billboard" } }, "/apis/v1/tikhub/douyin/creator/fetch_creator_hot_topic_billboard": { "get": { "description": "Douyin (creator).\n\n### Purpose:\n- Get Douyin creator hot topic billboard data\n### Parameters:\n- billboard_tag: Billboard tag, 0=all, other values can be obtained through config interface\n - 0: All\n - 333: Food\n - 334: Travel\n - 299: Lifestyle\n - 335: Automotive\n - 336: Technology\n - 302: Gaming\n - 296: Anime\n - 337: Entertainment\n - 311: Celebrity\n - 298: Sports\n - 300: Culture & Education\n - 301: Campus\n - 297: Government\n - 305: Fashion\n - 306: Talent Show\n - 669: Finance\n - 314: Random\n - 307: Animals & Plants\n - 309: Graphics & Text\n - 308: Drama\n - 315: Parenting\n - 718: Agriculture\n - 310: Creative\n - 312: Outdoor\n - 926: Public Welfare\n- order_key: Order key\n - 1: Highest views\n - 2: Most likes\n - 3: Most comments\n - 4: Most submissions\n- time_filter: Time filter\n - 1: 24 hours\n - 2: 7 days\n - 3: 30 days\n### Return:\n- Creator hot topic billboard data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_creator_fetch_creator_hot_topic_billboard", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Creator hot topic billboard data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_creator_hot_topic_billboard", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "06eb1a2d98e2" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/creator/fetch_creator_hot_topic_billboard", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_creator_fetch_creator_hot_topic_billboard", "method": "GET", "path": "/apis/v1/tikhub/douyin/creator/fetch_creator_hot_topic_billboard" }, "parameters": [ { "name": "billboard_tag", "in": "query", "required": false, "schema": { "type": "integer", "description": "Billboard tag, 0=all, other values can be obtained through config interface\n - 0: All\n - 333: Food\n - 334: Travel\n - 299: Lifestyle\n - 335: Automotive\n - 336: Technology\n - 302: Gaming\n - 296: Anime\n - 337: Entertainment\n - 311: Celebrity\n - 298: Sports\n - 300: Culture & Education\n - 301: Campus\n - 297: Government\n - 305: Fashion\n - 306: Talent Show\n - 669: Finance\n - 314: Random\n - 307: Animals & Plants\n - 309: Graphics & Text\n - 308: Drama\n - 315: Parenting\n - 718: Agriculture\n - 310: Creative\n - 312: Outdoor\n - 926: Public Welfare", "default": 0, "title": "Billboard Tag" }, "description": "Billboard tag, 0=all, other values can be obtained through config interface\n - 0: All\n - 333: Food\n - 334: Travel\n - 299: Lifestyle\n - 335: Automotive\n - 336: Technology\n - 302: Gaming\n - 296: Anime\n - 337: Entertainment\n - 311: Celebrity\n - 298: Sports\n - 300: Culture & Education\n - 301: Campus\n - 297: Government\n - 305: Fashion\n - 306: Talent Show\n - 669: Finance\n - 314: Random\n - 307: Animals & Plants\n - 309: Graphics & Text\n - 308: Drama\n - 315: Parenting\n - 718: Agriculture\n - 310: Creative\n - 312: Outdoor\n - 926: Public Welfare" }, { "name": "order_key", "in": "query", "required": false, "schema": { "type": "integer", "description": "Order key: 1=highest views, 2=most likes, 3=most comments, 4=most submissions", "default": 1, "title": "Order Key" }, "description": "Order key: 1=highest views, 2=most likes, 3=most comments, 4=most submissions" }, { "name": "time_filter", "in": "query", "required": false, "schema": { "type": "integer", "description": "Time filter: 1=24 hours, 2=7 days, 3=30 days", "default": 1, "title": "Time Filter" }, "description": "Time filter: 1=24 hours, 2=7 days, 3=30 days" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:794152ab598bb09cdf425c5227a467885c57136cd411fb966a498f842e252b15" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-creator-fetch_creator_hot_topic_billboard" } }, "/apis/v1/tikhub/douyin/creator/fetch_creator_material_center_billboard": { "get": { "description": "Douyin (creator).\n\n### Purpose:\n- Get Douyin creator material center billboard data\n### Parameters:\n- billboard_tag: Billboard tag, 0=all, other values can be obtained through config interface\n - 0: All\n - 333: Food\n - 334: Travel\n - 299: Lifestyle\n - 335: Automotive\n - 336: Technology\n - 302: Gaming\n - 296: Anime\n - 337: Entertainment\n - 311: Celebrity\n - 298: Sports\n - 300: Culture & Education\n - 301: Campus\n - 297: Government\n - 305: Fashion\n - 306: Talent Show\n - 669: Finance\n - 314: Random\n - 307: Animals & Plants\n - 309: Graphics & Text\n - 308: Drama\n - 315: Parenting\n - 718: Agriculture\n - 310: Creative\n - 312: Outdoor\n - 926: Public Welfare\n- order_key: Order key\n - 1: Highest views\n - 2: Most likes\n - 3: Most comments\n - 4: Highest popularity\n- time_filter: Time filter\n - 1: 24 hours\n - 2: 7 days\n - 3: 30 days\n### Return:\n- Creator material center billboard data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_creator_fetch_creator_material_center_billboard", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Creator material center billboard data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_creator_material_center_billboard", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "e0fdc4a6b1ed" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/creator/fetch_creator_material_center_billboard", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_creator_fetch_creator_material_center_billboard", "method": "GET", "path": "/apis/v1/tikhub/douyin/creator/fetch_creator_material_center_billboard" }, "parameters": [ { "name": "billboard_tag", "in": "query", "required": false, "schema": { "type": "integer", "description": "Billboard tag, 0=all, other values can be obtained through config interface\n - 0: All\n - 333: Food\n - 334: Travel\n - 299: Lifestyle\n - 335: Automotive\n - 336: Technology\n - 302: Gaming\n - 296: Anime\n - 337: Entertainment\n - 311: Celebrity\n - 298: Sports\n - 300: Culture & Education\n - 301: Campus\n - 297: Government\n - 305: Fashion\n - 306: Talent Show\n - 669: Finance\n - 314: Random\n - 307: Animals & Plants\n - 309: Graphics & Text\n - 308: Drama\n - 315: Parenting\n - 718: Agriculture\n - 310: Creative\n - 312: Outdoor\n - 926: Public Welfare", "default": 0, "title": "Billboard Tag" }, "description": "Billboard tag, 0=all, other values can be obtained through config interface\n - 0: All\n - 333: Food\n - 334: Travel\n - 299: Lifestyle\n - 335: Automotive\n - 336: Technology\n - 302: Gaming\n - 296: Anime\n - 337: Entertainment\n - 311: Celebrity\n - 298: Sports\n - 300: Culture & Education\n - 301: Campus\n - 297: Government\n - 305: Fashion\n - 306: Talent Show\n - 669: Finance\n - 314: Random\n - 307: Animals & Plants\n - 309: Graphics & Text\n - 308: Drama\n - 315: Parenting\n - 718: Agriculture\n - 310: Creative\n - 312: Outdoor\n - 926: Public Welfare" }, { "name": "order_key", "in": "query", "required": false, "schema": { "type": "integer", "description": "Order key: 1=highest views, 2=most likes, 3=most comments, 4=highest popularity", "default": 1, "title": "Order Key" }, "description": "Order key: 1=highest views, 2=most likes, 3=most comments, 4=highest popularity" }, { "name": "time_filter", "in": "query", "required": false, "schema": { "type": "integer", "description": "Time filter: 1=24 hours, 2=7 days, 3=30 days", "default": 1, "title": "Time Filter" }, "description": "Time filter: 1=24 hours, 2=7 days, 3=30 days" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:af76c64607cd8638bc7cb69b2fa367d246b77042c1ba85132c0e1f39480b6ead" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-creator-fetch_creator_material_center_billboard" } }, "/apis/v1/tikhub/douyin/creator/fetch_creator_material_center_config": { "get": { "description": "Douyin (creator).\n\n### Purpose:\n- Get Douyin creator material center configuration\n### Return:\n- Creator material center config data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_creator_fetch_creator_material_center_config", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Creator material center config data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_creator_material_center_config", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "9249adb67e94" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/creator/fetch_creator_material_center_config", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_creator_fetch_creator_material_center_config", "method": "GET", "path": "/apis/v1/tikhub/douyin/creator/fetch_creator_material_center_config" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:4ffba06672e5dacd803204fb9a56270418f3f8e5c714ed2c37fee7b59ac8a7cf" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-creator-fetch_creator_material_center_config" } }, "/apis/v1/tikhub/douyin/creator/fetch_creator_material_center_related": { "get": { "description": "Douyin (creator).\n\n### Purpose:\n- Get related videos for a topic/hot spot/prop/music item in Douyin creator material center\n- Retrieve query_id from upstream billboard endpoints first, then call this API to fetch related videos\n### Parameters:\n- query_id: Query ID (topic_id / hot_id obtained from billboard endpoints)\n- billboard_type: Billboard type\n - 2: Hot spot\n - 3: Topic\n - 4: Props\n - 5: Music\n- limit: Items per page (default 20, range 1-100)\n- offset: Offset (starting position for pagination)\n### Return:\n- Related videos list data for the given query_id\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_creator_fetch_creator_material_center_related", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Related videos list data for the given query_id", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_creator_material_center_related", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "e29aedd66bad" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/creator/fetch_creator_material_center_related", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_creator_fetch_creator_material_center_related", "method": "GET", "path": "/apis/v1/tikhub/douyin/creator/fetch_creator_material_center_related" }, "parameters": [ { "name": "billboard_type", "in": "query", "required": false, "schema": { "type": "integer", "description": "Billboard type (2=Hot Topics, 3=Topics, 4=Props, 5=Music)\n\nUsage: Billboard type\n - 2: Hot spot\n - 3: Topic\n - 4: Props\n - 5: Music", "default": 2, "title": "Billboard Type" }, "description": "Billboard type (2=Hot Topics, 3=Topics, 4=Props, 5=Music)\n\nUsage: Billboard type\n - 2: Hot spot\n - 3: Topic\n - 4: Props\n - 5: Music", "example": 2 }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 1, "description": "Items per page (default 20, range 1-100)", "default": 20, "title": "Limit" }, "description": "Items per page (default 20, range 1-100)", "example": 20 }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "description": "Offset (starting position for pagination)", "default": 0, "title": "Offset" }, "description": "Offset (starting position for pagination)", "example": 0 }, { "name": "query_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Query ID (topic ID or hot-spot ID, obtained from other ranking list endpoints)\n\nUsage: Query ID (topic_id / hot_id obtained from billboard endpoints)", "title": "Query Id" }, "description": "Query ID (topic ID or hot-spot ID, obtained from other ranking list endpoints)\n\nUsage: Query ID (topic_id / hot_id obtained from billboard endpoints)", "example": "2488260" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:6d46247a458a2d24afc391e89a15b72ec4e8448400ea08ab541c6218544daf1d" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/creator/fetch_creator_material_center_related?billboard_type=2&limit=20&offset=0&query_id=2488260' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-creator-fetch_creator_material_center_related" } }, "/apis/v1/tikhub/douyin/creator/fetch_industry_category_config": { "get": { "description": "Douyin (creator).\n\n### Purpose:\n- Get industry category configuration from Douyin Creator platform\n- Returns all available industry classification hierarchy\n- **Recommend calling this API first before using mission task list API to get complete industry classification info**\n\n### Important Notes:\n- This API is optimized with Redis caching, data will be cached for 30 days after first call\n- Cache key: `douyin_creator:industry_categories`\n- Data structure contains complete mapping relationship between primary and secondary industries\n\n### Data Structure:\n```json\n{\n \"status_code\": 0,\n \"status_msg\": \"success\",\n \"data\": {\n \"industry_categories\": [\n {\"key\": \"-1\", \"label\": \"All\"},\n {\"key\": 1901, \"label\": \"3C & Electronics\"},\n {\"key\": 1913, \"label\": \"Gaming\"},\n ...\n ],\n \"industry_subcategories\": {\n 1913: [\n {\"key\": \"-1\", \"label\": \"All\"},\n {\"key\": 191301, \"label\": \"Casual Games\"},\n {\"key\": 191302, \"label\": \"Board Games\"},\n ...\n ],\n ...\n }\n }\n}\n```\n\n### Usage in Mission Task Filtering:\n1. **Get all industry tasks**: `industry_lv1=-1` (industry_lv2 not needed)\n2. **Get specific primary industry**: `industry_lv1=1913` (Gaming industry)\n3. **Get specific secondary industry**: `industry_lv1=1913&industry_lv2=191301` (Gaming-Casual Games)\n\n### Performance Optimization:\n- First call reads from local JSON file and caches to Redis\n- Subsequent calls read directly from Redis cache, significantly improving response speed\n- Cache validity period of 30 days ensures data timeliness\n\n### Return:\n- Returns complete industry classification tree structure\n- Contains 32 primary industry categories and corresponding secondary industry categories\n- Each category contains category ID(key) and name(label)\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_creator_fetch_industry_category_config", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Returns complete industry classification tree structure\n- Contains 32 primary industry categories and corresponding secondary industry categories\n- Each category contains category ID(key) and name(label)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_industry_category_config", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "ff06b710af11" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/creator/fetch_industry_category_config", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_creator_fetch_industry_category_config", "method": "GET", "path": "/apis/v1/tikhub/douyin/creator/fetch_industry_category_config" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:1b189035de91d75a558806186fba4aab1fac184b143fb682d7488b94df525cf3" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-creator-fetch_industry_category_config" } }, "/apis/v1/tikhub/douyin/creator/fetch_mission_task_list": { "get": { "description": "Douyin (creator).\n\n### Purpose\n- Get mission task list from Douyin Creator platform\n- Supports multiple filtering conditions including industry classification, payment type, platform channel, etc.\n\n### Important Parameter Usage Guidelines\n#### Industry Classification Combination Rules:\n- **industry_lv1=-1 (All)**: When selecting all primary industries, industry_lv2 parameter will be ignored, no need to set\n- **industry_lv1=specific value**: When selecting specific primary industry, can be combined with industry_lv2 for secondary filtering\n - industry_lv2=-1: All secondary categories under the primary industry\n - industry_lv2=specific value: Specific secondary category under the primary industry\n\n#### Optional Parameters (No need to pass when selecting \"All\"):\n- **platform_channel**: Not passing means all platform channels\n- **pay_type**: Not passing means all payment types\n- **greater_than_cost_progress**: Not passing means no cost progress restriction\n- **publish_time_start**: Not passing means no publish time restriction\n- **quick_selector_scene**: Not passing means no quick filtering\n- **keyword**: Not passing means no keyword search\n\n### Parameter Details\n- cursor: Cursor for pagination, 0 for first page\n- limit: Number of tasks per page, recommended 24\n- mission_type: Mission type, usually 1\n- tab_scene: Scene type\n - 1: Submittable (tasks that can be submitted directly)\n - 2: Registrable (tasks that require registration and approval)\n - 3: Product Review (product evaluation tasks)\n- industry_lv1/lv2: Industry classification (recommend calling fetch_industry_category_config first)\n - -1: All industries\n - Specific values: Corresponding to specific industry categories (e.g., 1913=Gaming, 1903=Food&Beverage)\n- platform_channel: Platform channel (optional)\n - 1: Douyin Video\n - 2: Douyin Live\n - 3: Douyin Image&Text\n- pay_type: Payment type (optional)\n - 1: Video Level (pricing by follower level)\n - 2: Custom (merchant custom pricing)\n - 3: Conversion-based (pay by conversion effect)\n - 4: Valid Views (pay by view count)\n - 5: Sales Volume (pay by product sales)\n - 9: Verification Volume (pay by verification count)\n - 14: Commission-based (pay by commission ratio)\n- greater_than_cost_progress: Cost progress filter (optional)\n - 20: Tasks with more than 20% cost progress\n - 50: Tasks with more than 50% cost progress\n - 80: Tasks with more than 80% cost progress\n- publish_time_start: Publish start time filter (optional, timestamp format)\n- quick_selector_scene: Quick filter scene (optional)\n - 1: High revenue tasks\n - 4: Guaranteed income tasks\n - 5: Previously collaborated merchants\n- keyword: Keyword search (optional, supports task name or task ID)\n\n### Usage Examples\n```\n# Get submittable tasks from all industries\nGET /tikhub/douyin/creator/fetch_mission_task_list?industry_lv1=-1&tab_scene=1\n\n# Get tasks from gaming industry casual games category with view-based payment\nGET /tikhub/douyin/creator/fetch_mission_task_list?industry_lv1=1913&industry_lv2=191301&pay_type=4\n\n# Get high-revenue Douyin video tasks\nGET /tikhub/douyin/creator/fetch_mission_task_list?platform_channel=1&quick_selector_scene=1\n```\n\n### Return\n- Returns mission task list matching the conditions\n- Contains task details, compensation info, requirements, etc.\n\nAPI references: `fetch_industry_category_config` = `GET /tikhub/douyin/creator/fetch_industry_category_config` (operationId: `get_tikhub_douyin_creator_fetch_industry_category_config`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_creator_fetch_mission_task_list", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Returns mission task list matching the conditions\n- Contains task details, compensation info, requirements, etc.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_mission_task_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "288ea3435cb3" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/creator/fetch_mission_task_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_creator_fetch_mission_task_list", "method": "GET", "path": "/apis/v1/tikhub/douyin/creator/fetch_mission_task_list" }, "parameters": [ { "name": "cursor", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "description": "Cursor (pagination)", "default": 0, "title": "Cursor" }, "description": "Cursor (pagination)", "example": 0 }, { "name": "greater_than_cost_progress", "in": "query", "required": false, "schema": { "description": "Cost progress (20=above 20%, 50=above 50%, 80=above 80%)", "title": "Greater Than Cost Progress", "type": [ "integer", "null" ] }, "description": "Cost progress (20=above 20%, 50=above 50%, 80=above 80%)", "example": 20 }, { "name": "industry_lv1", "in": "query", "required": false, "schema": { "type": "integer", "description": "Primary industry (-1=all)", "default": -1, "title": "Industry Lv1" }, "description": "Primary industry (-1=all)", "example": 1913 }, { "name": "industry_lv2", "in": "query", "required": false, "schema": { "type": "integer", "description": "Secondary industry (-1=all)", "default": -1, "title": "Industry Lv2" }, "description": "Secondary industry (-1=all)", "example": 191301 }, { "name": "keyword", "in": "query", "required": false, "schema": { "description": "Keyword (task name or ID)", "title": "Keyword", "type": [ "string", "null" ] }, "description": "Keyword (task name or ID)" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 1, "description": "Items per page", "default": 24, "title": "Limit" }, "description": "Items per page", "example": 24 }, { "name": "mission_type", "in": "query", "required": false, "schema": { "type": "integer", "description": "Mission type", "default": 1, "title": "Mission Type" }, "description": "Mission type", "example": 1 }, { "name": "pay_type", "in": "query", "required": false, "schema": { "description": "Pay type: 1=video level, 2=custom, 3=pay per conversion, 4=pay per valid view, 5=pay per sale, 9=pay per redemption, 14=pay per commission", "title": "Pay Type", "type": [ "integer", "null" ] }, "description": "Pay type: 1=video level, 2=custom, 3=pay per conversion, 4=pay per valid view, 5=pay per sale, 9=pay per redemption, 14=pay per commission", "example": 4 }, { "name": "platform_channel", "in": "query", "required": false, "schema": { "description": "Platform channel: 1=Douyin video, 2=Douyin live, 3=Douyin image+text", "title": "Platform Channel", "type": [ "integer", "null" ] }, "description": "Platform channel: 1=Douyin video, 2=Douyin live, 3=Douyin image+text", "example": 1 }, { "name": "publish_time_start", "in": "query", "required": false, "schema": { "description": "Publish start time (timestamp)", "title": "Publish Time Start", "type": [ "integer", "null" ] }, "description": "Publish start time (timestamp)", "example": 1757097636 }, { "name": "quick_selector_scene", "in": "query", "required": false, "schema": { "description": "Quick selector (1=high revenue, 4=guaranteed income, 5=previously cooperated)", "title": "Quick Selector Scene", "type": [ "integer", "null" ] }, "description": "Quick selector (1=high revenue, 4=guaranteed income, 5=previously cooperated)" }, { "name": "tab_scene", "in": "query", "required": false, "schema": { "type": "integer", "description": "Scene type: 1=Submittable, 2=Registerable, 3=Product review\n\nUsage: Scene type\n - 1: Submittable (tasks that can be submitted directly)\n - 2: Registrable (tasks that require registration and approval)\n - 3: Product Review (product evaluation tasks)", "default": 1, "title": "Tab Scene" }, "description": "Scene type: 1=Submittable, 2=Registerable, 3=Product review\n\nUsage: Scene type\n - 1: Submittable (tasks that can be submitted directly)\n - 2: Registrable (tasks that require registration and approval)\n - 3: Product Review (product evaluation tasks)", "example": 1 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:bf6292edc54531345d70dcbf8c75b0f3003ea3137494d7393df8e01426ddf4af" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-creator-fetch_mission_task_list" } }, "/apis/v1/tikhub/douyin/creator/fetch_user_search": { "get": { "description": "Douyin (creator).\n\n### Purpose\n- Search Douyin users by Douyin ID or nickname\n\n### Parameters\n- user_name: Username (supports Douyin ID and nickname)\n - Douyin ID: e.g., \"rmrbxmt\"\n - Nickname: e.g., \"Y\", \"People's Daily\"\n\n### Return\n- Returns up to 20 matching user information\n- Contains basic user info like avatar, nickname, Douyin ID, etc.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_creator_fetch_user_search", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Returns up to 20 matching user information\n- Contains basic user info like avatar, nickname, Douyin ID, etc.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_user_search", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "d258d4387e21" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/creator/fetch_user_search", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_creator_fetch_user_search", "method": "GET", "path": "/apis/v1/tikhub/douyin/creator/fetch_user_search" }, "parameters": [ { "name": "user_name", "in": "query", "required": true, "schema": { "type": "string", "description": "Username for searching users. Supports a Douyin account ID or the actual account nickname.", "title": "User Name" }, "description": "Username for searching users. Supports a Douyin account ID or the actual account nickname.", "example": "Y" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:75071c31dff13dbf0cad5f5d3e8c31f98ceaf7033ee1486963f8da6198f75665" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/creator/fetch_user_search?user_name=Y' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-creator-fetch_user_search" } }, "/apis/v1/tikhub/douyin/creator/fetch_video_danmaku_list": { "get": { "description": "Douyin (creator).\n\n### Purpose:\n- Get danmaku list for specified video, supports management and filtering\n### Parameters:\n- item_id: Video item ID (required, get from video link or API)\n- count: Items per page (recommended 20, range 1-100)\n- offset: Offset (for pagination, starting position)\n- order_type: Order type (1=time order, 2=other order)\n- is_blocked: Whether to get blocked danmaku (false=normal, true=blocked)\n### Return:\n- Video danmaku list data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_creator_fetch_video_danmaku_list", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Video danmaku list data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_video_danmaku_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "4587cb6ce88a" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/creator/fetch_video_danmaku_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_creator_fetch_video_danmaku_list", "method": "GET", "path": "/apis/v1/tikhub/douyin/creator/fetch_video_danmaku_list" }, "parameters": [ { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 1, "description": "Items per page (recommended 20, range 1-100)", "default": 20, "title": "Count" }, "description": "Items per page (recommended 20, range 1-100)", "example": 20 }, { "name": "is_blocked", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether to get blocked danmaku (false=normal, true=blocked)", "default": false, "title": "Is Blocked" }, "description": "Whether to get blocked danmaku (false=normal, true=blocked)", "example": false }, { "name": "item_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Video item ID (required, get from video link or API)", "title": "Item Id" }, "description": "Video item ID (required, get from video link or API)", "example": "7545659154417896746" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "description": "Offset (starting position)", "default": 0, "title": "Offset" }, "description": "Offset (starting position)", "example": 0 }, { "name": "order_type", "in": "query", "required": false, "schema": { "type": "integer", "description": "Order type: 1=sort by time, 2=other sort", "default": 1, "title": "Order Type" }, "description": "Order type: 1=sort by time, 2=other sort", "example": 1 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:70f48dcc4ce2e3d5a6e00ecbe965609c19bade13c278d6768d9733fea68b124b" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/creator/fetch_video_danmaku_list?count=20&is_blocked=false&item_id=7545659154417896746&offset=0&order_type=1' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-creator-fetch_video_danmaku_list" } }, "/apis/v1/tikhub/douyin/creator_v2/fetch_author_diagnosis": { "post": { "description": "Douyin (creator_v2).\n\n### Purpose:\n- Get Douyin creator account diagnosis data and optimization suggestions\n- Automatically analyze account performance for the past 7 days\n- Provide assessment and improvement suggestions for key metrics\n- Help creators understand account health and optimize content strategy\n- **This API requires valid Douyin Creator Platform Cookie**\n- **Use POST method, Cookie transmitted in request body, more secure**\n- **No need to specify time range, system automatically fetches data for past 7 days**\n\n### Request Body Parameters:\n- cookie: User's Douyin Creator Platform Cookie (required)\n\n### Data Update Time:\n- **Update Cycle**: Yesterday's video data is updated at 12:00 noon the next day\n- **Example**: Video data from October 10, 2025 will be updated at 12:00 on October 11, 2025\n- **Time Range**: Automatically fetches data for the past 7 days\n- **First Use**: Data generation starts from the next day after obtaining permission\n\n### Data Metrics Definition:\n\n**Term Definitions**:\n- **Similar Creators**: Creators with similar creation fields or fan levels\n- **Time Granularity**: The period for data update calculations\n- **Douyin Featured**: Data performance including Featured APP + Douyin Desktop + Douyin APP Featured Tab\n\n**Account Diagnosis Metrics**:\n- **Submission Count**: Number of works published during the statistical period\n- **Engagement Index**: Comprehensive score of views, likes, comments, and shares\n- **Video Views**: Number of times the work has been viewed\n- **Video Completion Rate**: Proportion of complete playbacks\n - Daily completion rate: Ratio of daily complete views to total views\n - 10-minute completion rate: Ratio of cumulative complete views to cumulative views\n- **Net Fan Growth**: Net increase in account followers (new followers minus unfollowers)\n\n### Return Data Description:\nAccount diagnosis data including five core dimensions:\n\n**1. Engagement Index (Interact)**:\n- **OwnValue**: Account's own engagement index value (comprehensive score of views, likes, comments, shares)\n- **SimilarCount**: Total number of similar creators\n- **AuthorRank**: Ranking percentile in account's historical data (0-1, higher means better current performance)\n- **SimilarRank**: Ranking percentile among similar creators (0-1, higher means better ranking)\n- **SimilarValue**: Average engagement index value of similar creators\n- **Interpretation**: AuthorRank=0.26 means current engagement exceeds 26% of own history\n- **Interpretation**: SimilarRank=0.52 means ranking exceeds 52% of similar creators\n\n**2. Net Fan Growth (NewFans)**:\n- **OwnValue**: Net increase in followers during the period (new followers - unfollowers)\n- **SimilarCount**: Total number of similar creators\n- **AuthorRank**: Ranking percentile in account's historical fan growth data\n- **SimilarRank**: Fan growth ranking percentile among similar creators\n- **SimilarValue**: Average net fan growth of similar creators\n- **Interpretation**: OwnValue=2 means net gain of 2 followers in this period\n\n**3. Video Views (PlayCnt)**:\n- **OwnValue**: Total number of times works were viewed during the period\n- **SimilarCount**: Total number of similar creators\n- **AuthorRank**: Ranking percentile in account's historical view count\n- **SimilarRank**: View count ranking percentile among similar creators\n- **SimilarValue**: Average view count of similar creators\n- **Interpretation**: OwnValue=192 means total views of 192 in this period\n\n**4. Video Completion Rate (PlayFinishRatio)**:\n- **OwnValue**: Proportion of complete playbacks (decimal between 0-1)\n- **SimilarCount**: Total number of similar creators\n- **AuthorRank**: Ranking percentile in account's historical completion rate\n- **SimilarRank**: Completion rate ranking percentile among similar creators\n- **SimilarValue**: Average completion rate of similar creators\n- **Interpretation**: OwnValue=0.15 means 15% completion rate\n- **Tip**: Focus on first 3 seconds to improve retention\n\n**5. Publishing Activity (PublishActivation)**:\n- **OwnValue**: Number of works published during the period\n- **SimilarCount**: Total number of similar creators\n- **AuthorRank**: Ranking percentile in account's historical publishing data\n- **SimilarRank**: Publishing activity ranking percentile among similar creators\n- **SimilarValue**: Average number of submissions by similar creators\n- **Interpretation**: OwnValue=2 means published 2 works in this period\n\n### Return Data Structure Example:\n```json\n{\n \"code\": 0,\n \"data\": {\n \"Interact\": {\n \"OwnValue\": 0.0052,\n \"SimilarCount\": 1494654282,\n \"AuthorRank\": 0.2633,\n \"SimilarRank\": 0.5169,\n \"SimilarValue\": 0.0909\n },\n \"NewFans\": {\n \"OwnValue\": 2,\n \"AuthorRank\": 0.7924,\n \"SimilarRank\": 0.6343\n },\n \"PlayCnt\": {\n \"OwnValue\": 192,\n \"AuthorRank\": 0.8427,\n \"SimilarRank\": 0.5132\n },\n \"PlayFinishRatio\": {\n \"OwnValue\": 0.1545,\n \"AuthorRank\": 0.3851,\n \"SimilarRank\": 0.5086\n },\n \"PublishActivation\": {\n \"OwnValue\": 2,\n \"AuthorRank\": 0.7345,\n \"SimilarRank\": 0.5675\n }\n }\n}\n```\n\n### Data Interpretation Tips:\n- **OwnValue**: Check actual values to understand current account performance\n- **AuthorRank**: Compare with own past, higher value means better current status\n- **SimilarRank**: Compare with peers, higher value means better ranking among similar creators\n- **Recommendation**: Focus on optimizing metrics when both AuthorRank and SimilarRank are below 0.5\n\n### How to get Cookie:\n1. Login to Douyin Creator Platform (https://creator.douyin.com)\n2. Open browser developer tools (F12)\n3. Switch to Network tab\n4. Refresh page or perform operations\n5. Copy the Cookie header value\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_creator_v2_fetch_author_diagnosis", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return Data Description\nAccount diagnosis data including five core dimensions:\n\n**1. Engagement Index (Interact)**:\n- **OwnValue**: Account's own engagement index value (comprehensive score of views, likes, comments, shares)\n- **SimilarCount**: Total number of similar creators\n- **AuthorRank**: Ranking percentile in account's historical data (0-1, higher means better current performance)\n- **SimilarRank**: Ranking percentile among similar creators (0-1, higher means better ranking)\n- **SimilarValue**: Average engagement index value of similar creators\n- **Interpretation**: AuthorRank=0.26 means current engagement exceeds 26% of own history\n- **Interpretation**: SimilarRank=0.52 means ranking exceeds 52% of similar creators\n\n**2. Net Fan Growth (NewFans)**:\n- **OwnValue**: Net increase in followers during the period (new followers - unfollowers)\n- **SimilarCount**: Total number of similar creators\n- **AuthorRank**: Ranking percentile in account's historical fan growth data\n- **SimilarRank**: Fan growth ranking percentile among similar creators\n- **SimilarValue**: Average net fan growth of similar creators\n- **Interpretation**: OwnValue=2 means net gain of 2 followers in this period\n\n**3. Video Views (PlayCnt)**:\n- **OwnValue**: Total number of times works were viewed during the period\n- **SimilarCount**: Total number of similar creators\n- **AuthorRank**: Ranking percentile in account's historical view count\n- **SimilarRank**: View count ranking percentile among similar creators\n- **SimilarValue**: Average view count of similar creators\n- **Interpretation**: OwnValue=192 means total views of 192 in this period\n\n**4. Video Completion Rate (PlayFinishRatio)**:\n- **OwnValue**: Proportion of complete playbacks (decimal between 0-1)\n- **SimilarCount**: Total number of similar creators\n- **AuthorRank**: Ranking percentile in account's historical completion rate\n- **SimilarRank**: Completion rate ranking percentile among similar creators\n- **SimilarValue**: Average completion rate of similar creators\n- **Interpretation**: OwnValue=0.15 means 15% completion rate\n- **Tip**: Focus on first 3 seconds to improve retention\n\n**5. Publishing Activity (PublishActivation)**:\n- **OwnValue**: Number of works published during the period\n- **SimilarCount**: Total number of similar creators\n- **AuthorRank**: Ranking percentile in account's historical publishing data\n- **SimilarRank**: Publishing activity ranking percentile among similar creators\n- **SimilarValue**: Average number of submissions by similar creators\n- **Interpretation**: OwnValue=2 means published 2 works in this period\n\n### Return Data Structure Example\n```json\n{\n \"code\": 0,\n \"data\": {\n \"Interact\": {\n \"OwnValue\": 0.0052,\n \"SimilarCount\": 1494654282,\n \"AuthorRank\": 0.2633,\n \"SimilarRank\": 0.5169,\n \"SimilarValue\": 0.0909\n },\n \"NewFans\": {\n \"OwnValue\": 2,\n \"AuthorRank\": 0.7924,\n \"SimilarRank\": 0.6343\n },\n \"PlayCnt\": {\n \"OwnValue\": 192,\n \"AuthorRank\": 0.8427,\n \"SimilarRank\": 0.5132\n },\n \"PlayFinishRatio\": {\n \"OwnValue\": 0.1545,\n \"AuthorRank\": 0.3851,\n \"SimilarRank\": 0.5086\n },\n \"PublishActivation\": {\n \"OwnValue\": 2,\n \"AuthorRank\": 0.7345,\n \"SimilarRank\": 0.5675\n }\n }\n}\n```", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_author_diagnosis", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "66ff1257b5c6" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/creator_v2/fetch_author_diagnosis", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_creator_v2_fetch_author_diagnosis", "method": "POST", "path": "/apis/v1/tikhub/douyin/creator_v2/fetch_author_diagnosis" }, "requestBody": { "content": { "application/json": { "schema": { "description": "Author diagnosis request parameters", "allOf": [ { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User's Douyin Creator Platform Cookie (required)", "example": "Your_Cookie_Here" } }, "type": "object", "required": [ "cookie" ], "title": "AuthorDiagnosisRequest", "description": "Author Diagnosis Request Model\n\nThis API requires no additional parameters, automatically fetches diagnosis data for the past 7 days" } ] }, "example": { "cookie": "Your_Cookie_Here" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:6d47a12365d0de4cbbfae9b464df17835e84196da5f4cf03e382b97fd302c70a" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/douyin/creator_v2/fetch_author_diagnosis \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"cookie\": \"Your_Cookie_Here\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-creator_v2-fetch_author_diagnosis" } }, "/apis/v1/tikhub/douyin/creator_v2/fetch_item_analysis_involved_vertical": { "post": { "description": "Douyin (creator_v2).\n\n### Purpose:\n- Get the vertical tags involved in submitted items within the specified time period\n- Used as parameters for subsequent calls to the submission analysis interface\n- **This API requires users to provide valid Douyin Creator Platform Cookie**\n- **Use POST method, Cookie is transmitted in request body, more secure**\n\n### Request Body Parameters:\n- cookie: User's Douyin Creator Platform Cookie (required, transmitted in request body)\n- start_date: Start date in YYYYMMDD format (required)\n- end_date: End date in YYYYMMDD format (required)\n- **Note: Date range maximum 90 days**\n\n### Return Data Description:\n- primary_verticals: List of vertical tags\n - Returns the verticals involved in items published during the specified time period\n - Example: [\"Animals\", \"Food\", \"Travel\"]\n\n### How to get Cookie:\n1. Login to Douyin Creator Platform (https://creator.douyin.com)\n2. Open browser developer tools (F12)\n3. Switch to Network tab\n4. Refresh page or perform operations\n5. Find any request and copy the Cookie header value\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_creator_v2_fetch_item_analysis_involved_vertical", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return Data Description\n- primary_verticals: List of vertical tags\n - Returns the verticals involved in items published during the specified time period\n - Example: [\"Animals\", \"Food\", \"Travel\"]", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_item_analysis_involved_vertical", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a6bd48d3bad8" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/creator_v2/fetch_item_analysis_involved_vertical", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_creator_v2_fetch_item_analysis_involved_vertical", "method": "POST", "path": "/apis/v1/tikhub/douyin/creator_v2/fetch_item_analysis_involved_vertical" }, "requestBody": { "content": { "application/json": { "schema": { "description": "Item analysis involved vertical request parameters", "allOf": [ { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User's Douyin Creator Platform Cookie (required, transmitted in request body)", "example": "Your_Cookie_Here" }, "start_date": { "type": "string", "title": "Start Date", "description": "Start date (format YYYYMMDD)", "example": "20250713" }, "end_date": { "type": "string", "title": "End Date", "description": "End date (format YYYYMMDD)", "example": "20251011" } }, "type": "object", "required": [ "cookie", "start_date", "end_date" ], "title": "ItemAnalysisInvolvedVerticalRequest", "description": "Item Analysis Involved Vertical Request Model" } ] }, "example": { "cookie": "Your_Cookie_Here", "start_date": "20250713", "end_date": "20251011" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:a623f3ec9673dc9f0be9974008481f76b16575cbd0c65286864fcaf7c1743bbb" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/douyin/creator_v2/fetch_item_analysis_involved_vertical \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"cookie\": \"Your_Cookie_Here\",\n \"start_date\": \"20250713\",\n \"end_date\": \"20251011\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-creator_v2-fetch_item_analysis_involved_vertical" } }, "/apis/v1/tikhub/douyin/creator_v2/fetch_item_analysis_item_performance": { "post": { "description": "Douyin (creator_v2).\n\n### Purpose:\n- Get performance data for submitted items, including views, likes, comments, shares, etc.\n- Analyze content performance across different genres and verticals\n- **This API requires users to provide valid Douyin Creator Platform Cookie**\n- **Use POST method, Cookie is transmitted in request body, more secure**\n- **Recommend calling fetch_item_analysis_involved_vertical first to get vertical tags**\n\n### Request Body Parameters:\n- cookie: User's Douyin Creator Platform Cookie (required, transmitted in request body)\n- start_date: Start date in YYYYMMDD format (required)\n- end_date: End date in YYYYMMDD format (required)\n- genres: Genre type list (optional, defaults to all genres)\n - 1: Videos under 1 minute\n - 2: 1-3 minute videos\n - 3: 3-5 minute videos\n - 4: Videos over 5 minutes\n - 5: Photo posts\n - 8: Long photo posts\n- primary_verticals: Vertical tag list (required, obtained from fetch_item_analysis_involved_vertical)\n- metric_type: Metric type (optional, defaults to 1)\n - 1: Views\n - 2: Likes\n - 3: Comments\n - 4: Shares\n- **Note: Date range maximum 90 days**\n\n### Return Data Description:\n- Contains performance data for selected metrics across different genres and verticals\n- Trend analysis and comparison data\n- Helps understand content performance across various dimensions\n\n### How to get Cookie:\n1. Login to Douyin Creator Platform (https://creator.douyin.com)\n2. Open browser developer tools (F12)\n3. Switch to Network tab\n4. Refresh page or perform operations\n5. Find any request and copy the Cookie header value\n\nAPI references: `fetch_item_analysis_involved_vertical` = `POST /tikhub/douyin/creator_v2/fetch_item_analysis_involved_vertical` (operationId: `post_tikhub_douyin_creator_v2_fetch_item_analysis_involved_vertical`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_creator_v2_fetch_item_analysis_item_performance", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return Data Description\n- Contains performance data for selected metrics across different genres and verticals\n- Trend analysis and comparison data\n- Helps understand content performance across various dimensions", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_item_analysis_item_performance", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "45368a873eea" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/creator_v2/fetch_item_analysis_item_performance", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_creator_v2_fetch_item_analysis_item_performance", "method": "POST", "path": "/apis/v1/tikhub/douyin/creator_v2/fetch_item_analysis_item_performance" }, "requestBody": { "content": { "application/json": { "schema": { "description": "Item analysis item performance request parameters", "allOf": [ { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User's Douyin Creator Platform Cookie (required, transmitted in request body)", "example": "Your_Cookie_Here" }, "start_date": { "type": "string", "title": "Start Date", "description": "Start date (format YYYYMMDD)", "example": "20250713" }, "end_date": { "type": "string", "title": "End Date", "description": "End date (format YYYYMMDD)", "example": "20251011" }, "genres": { "items": { "type": "integer" }, "type": "array", "title": "Genres", "description": "Genres list: 1=video under 1 min, 2=1-3 min video, 3=3-5 min video, 4=video over 5 min, 5=image+text, 8=long-form article\n\nUsage: Genre type list (optional, defaults to all genres)\n - 1: Videos under 1 minute\n - 2: 1-3 minute videos\n - 3: 3-5 minute videos\n - 4: Videos over 5 minutes\n - 5: Photo posts\n - 8: Long photo posts", "default": [ 1, 2, 3, 4, 5, 8 ], "example": [ 2, 3, 4, 5, 8 ] }, "primary_verticals": { "items": { "type": "string" }, "type": "array", "title": "Primary Verticals", "description": "Primary verticals list (obtained from the involved_vertical endpoint)\n\nUsage: Vertical tag list (required, obtained from fetch_item_analysis_involved_vertical)\n\nAPI references: `fetch_item_analysis_involved_vertical` = `POST /tikhub/douyin/creator_v2/fetch_item_analysis_involved_vertical` (operationId: `post_tikhub_douyin_creator_v2_fetch_item_analysis_involved_vertical`).", "example": [ "动物" ] }, "metric_type": { "type": "integer", "title": "Metric Type", "description": "Metric type: 1=Views, 2=Likes, 3=Comments, 4=Shares", "default": 1, "example": 1 } }, "type": "object", "required": [ "cookie", "start_date", "end_date", "primary_verticals" ], "title": "ItemAnalysisItemPerformanceRequest", "description": "Item Analysis Item Performance Request Model" } ] }, "example": { "cookie": "Your_Cookie_Here", "start_date": "20250713", "end_date": "20251011", "genres": [ 2, 3, 4, 5, 8 ], "primary_verticals": [ "动物" ], "metric_type": 1 } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:8b95945055809c4ae9deb832821ac33dbeffb5b80b11c535f1ccd2704401d791" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/douyin/creator_v2/fetch_item_analysis_item_performance \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"cookie\": \"Your_Cookie_Here\",\n \"start_date\": \"20250713\",\n \"end_date\": \"20251011\",\n \"genres\": [\n 2,\n 3,\n 4,\n 5,\n 8\n ],\n \"primary_verticals\": [\n \"动物\"\n ],\n \"metric_type\": 1\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-creator_v2-fetch_item_analysis_item_performance" } }, "/apis/v1/tikhub/douyin/creator_v2/fetch_item_analysis_overview": { "post": { "description": "Douyin (creator_v2).\n\n### Purpose:\n- Get comprehensive analysis data for account submitted items\n- Including submission performance statistics for different genres and verticals\n- **This API requires users to provide valid Douyin Creator Platform Cookie**\n- **Use POST method, Cookie is transmitted in request body, more secure**\n- **Recommend calling fetch_item_analysis_involved_vertical first to get vertical tags**\n\n### Request Body Parameters:\n- cookie: User's Douyin Creator Platform Cookie (required, transmitted in request body)\n- start_date: Start date in YYYYMMDD format (required)\n- end_date: End date in YYYYMMDD format (required)\n- genres: Genre type list (optional, defaults to all genres)\n - 1: Videos under 1 minute\n - 2: 1-3 minute videos\n - 3: 3-5 minute videos\n - 4: Videos over 5 minutes\n - 5: Photo posts\n - 8: Long photo posts\n- primary_verticals: Vertical tag list (required, obtained from fetch_item_analysis_involved_vertical)\n- **Note: Date range maximum 90 days**\n\n### Return Data Description:\n- Contains submission data analysis for different genres and verticals\n- Metrics including views, likes, comments, shares, etc.\n- Performance comparison of different genres\n\n### How to get Cookie:\n1. Login to Douyin Creator Platform (https://creator.douyin.com)\n2. Open browser developer tools (F12)\n3. Switch to Network tab\n4. Refresh page or perform operations\n5. Find any request and copy the Cookie header value\n\nAPI references: `fetch_item_analysis_involved_vertical` = `POST /tikhub/douyin/creator_v2/fetch_item_analysis_involved_vertical` (operationId: `post_tikhub_douyin_creator_v2_fetch_item_analysis_involved_vertical`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_creator_v2_fetch_item_analysis_overview", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return Data Description\n- Contains submission data analysis for different genres and verticals\n- Metrics including views, likes, comments, shares, etc.\n- Performance comparison of different genres", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_item_analysis_overview", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "181983a153a5" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/creator_v2/fetch_item_analysis_overview", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_creator_v2_fetch_item_analysis_overview", "method": "POST", "path": "/apis/v1/tikhub/douyin/creator_v2/fetch_item_analysis_overview" }, "requestBody": { "content": { "application/json": { "schema": { "description": "Item analysis overview request parameters", "allOf": [ { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User's Douyin Creator Platform Cookie (required, transmitted in request body)", "example": "Your_Cookie_Here" }, "start_date": { "type": "string", "title": "Start Date", "description": "Start date (format YYYYMMDD)", "example": "20250713" }, "end_date": { "type": "string", "title": "End Date", "description": "End date (format YYYYMMDD)", "example": "20251011" }, "genres": { "items": { "type": "integer" }, "type": "array", "title": "Genres", "description": "Genres list: 1=video under 1 min, 2=1-3 min video, 3=3-5 min video, 4=video over 5 min, 5=image+text, 8=long-form article\n\nUsage: Genre type list (optional, defaults to all genres)\n - 1: Videos under 1 minute\n - 2: 1-3 minute videos\n - 3: 3-5 minute videos\n - 4: Videos over 5 minutes\n - 5: Photo posts\n - 8: Long photo posts", "default": [ 1, 2, 3, 4, 5, 8 ], "example": [ 1, 2, 3, 4, 5, 8 ] }, "primary_verticals": { "items": { "type": "string" }, "type": "array", "title": "Primary Verticals", "description": "Primary verticals list (obtained from the involved_vertical endpoint)\n\nUsage: Vertical tag list (required, obtained from fetch_item_analysis_involved_vertical)\n\nAPI references: `fetch_item_analysis_involved_vertical` = `POST /tikhub/douyin/creator_v2/fetch_item_analysis_involved_vertical` (operationId: `post_tikhub_douyin_creator_v2_fetch_item_analysis_involved_vertical`).", "example": [ "动物" ] } }, "type": "object", "required": [ "cookie", "start_date", "end_date", "primary_verticals" ], "title": "ItemAnalysisOverviewRequest", "description": "Item Analysis Overview Request Model" } ] }, "example": { "cookie": "Your_Cookie_Here", "start_date": "20250713", "end_date": "20251011", "genres": [ 1, 2, 3, 4, 5, 8 ], "primary_verticals": [ "动物" ] } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:694aef557bc253a4377a24ca4abc0c4f5c5c05e2ba0d8378b049d3734faf3918" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/douyin/creator_v2/fetch_item_analysis_overview \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"cookie\": \"Your_Cookie_Here\",\n \"start_date\": \"20250713\",\n \"end_date\": \"20251011\",\n \"genres\": [\n 1,\n 2,\n 3,\n 4,\n 5,\n 8\n ],\n \"primary_verticals\": [\n \"动物\"\n ]\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-creator_v2-fetch_item_analysis_overview" } }, "/apis/v1/tikhub/douyin/creator_v2/fetch_item_audience_others": { "post": { "description": "Douyin (creator_v2).\n\n### Purpose:\n- Get Douyin item audience other data analysis, including audience distribution and audience keywords\n- Understand whether the audience are fans and what topics they are interested in\n- **This API requires users to provide valid Douyin Creator Platform Cookie**\n- **Use POST method, Cookie is transmitted in request body, more secure**\n\n### Request Body Parameters:\n- cookie: User's Douyin Creator Platform Cookie (required, transmitted in request body)\n- item_id: Item ID (required)\n\n### Return Data Description:\n- **audience_distribution (Audience Distribution)**:\n - fan_list: Fan proportion list\n - key: \"1\"=Fan, \"0\"=Non-fan\n - value: Proportion (decimal between 0-1)\n\n- **audience_keyword (Audience Keywords)**:\n - keyword_list: List of topics/keywords that audiences are interested in\n - keyword: Keyword content\n - value: Interest proportion for this keyword\n\n### How to get Cookie:\n1. Login to Douyin Creator Platform (https://creator.douyin.com)\n2. Open browser developer tools (F12)\n3. Switch to Network tab\n4. Refresh page or perform operations\n5. Find any request and copy the Cookie header value\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_creator_v2_fetch_item_audience_others", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return Data Description\n- **audience_distribution (Audience Distribution)**:\n - fan_list: Fan proportion list\n - key: \"1\"=Fan, \"0\"=Non-fan\n - value: Proportion (decimal between 0-1)\n\n- **audience_keyword (Audience Keywords)**:\n - keyword_list: List of topics/keywords that audiences are interested in\n - keyword: Keyword content\n - value: Interest proportion for this keyword", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_item_audience_others", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "33e8cf41953e" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/creator_v2/fetch_item_audience_others", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_creator_v2_fetch_item_audience_others", "method": "POST", "path": "/apis/v1/tikhub/douyin/creator_v2/fetch_item_audience_others" }, "requestBody": { "content": { "application/json": { "schema": { "description": "Item audience supplementary analysis request parameters", "allOf": [ { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User's Douyin Creator Platform Cookie (required, transmitted in request body)", "example": "Your_Cookie_Here" }, "item_id": { "type": "string", "title": "Item Id", "description": "Item ID", "example": "7559536212910853422" } }, "type": "object", "required": [ "cookie", "item_id" ], "title": "ItemAudienceOthersRequest", "description": "Item Audience Others Request Model" } ] }, "example": { "cookie": "Your_Cookie_Here", "item_id": "7559536212910853422" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:603b05d02c15ee1e9372e0b9fad08e83a938ac902b732cffa9689dcffe243fcd" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/douyin/creator_v2/fetch_item_audience_others \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"cookie\": \"Your_Cookie_Here\",\n \"item_id\": \"7559536212910853422\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-creator_v2-fetch_item_audience_others" } }, "/apis/v1/tikhub/douyin/creator_v2/fetch_item_audience_portrait": { "post": { "description": "Douyin (creator_v2).\n\n### Purpose\n- Get Douyin item audience portrait data\n- Understand viewer demographic characteristics\n- Includes active distribution, gender distribution, region distribution, age distribution\n- Help creators precisely target audiences and optimize content strategy\n- **This API requires users to provide valid Douyin Creator Platform Cookie**\n- **Use POST method, Cookie is transmitted in request body, more secure**\n\n### Request Body Parameters\n- cookie: User's Douyin Creator Platform Cookie (required, transmitted in request body)\n- item_id: Item ID (required)\n\n### Return Data Description\nReturns audience portrait data with multiple dimensions:\n\n**1. Active Distribution (active)**:\n- key: Time period identifier (\"2\"=morning, \"3\"=afternoon, \"4\"=evening, \"-1\"=other)\n- value: Active user ratio in this period (decimal between 0-1)\n\n**2. Gender Distribution (gender)**:\n- ratio_list: Gender ratio list\n - key: \"male\" or \"female\"\n - value: Gender user ratio (decimal between 0-1)\n- tgi_list: Gender TGI index list (Target Group Index)\n - key: Gender identifier\n - value: TGI value (100=average, >100=above average)\n\n**3. Region Distribution (province)**:\n- ratio_list: Province ratio list\n - key: Province name (e.g., \"浙江\", \"广东\", \"北京\")\n - value: Province user ratio (decimal between 0-1)\n- tgi_list: Province TGI index list\n - key: Province name\n - value: TGI value (reflects regional user activity)\n\n**4. Age Distribution (age)**:\n- ratio_list: Age range ratio list\n - key: Age range (\"-18\", \"18-23\", \"24-30\", \"31-40\", \"41-50\", \"50-\")\n - value: Age range user ratio (decimal between 0-1)\n- tgi_list: Age range TGI index list\n - key: Age range\n - value: TGI value (reflects age group preference)\n\n**5. Other Dimensions**:\n- career: Career distribution (may be empty)\n- city_level: City level distribution (contains ratio_list and tgi_list)\n- new_user: New user ratio (may be empty)\n\n**TGI Index Explanation**:\n- TGI = 100: Group performance matches platform average\n- TGI > 100: Group ratio is higher than platform average, core audience\n- TGI < 100: Group ratio is lower than platform average\n- Higher TGI indicates greater interest in this content type\n\n**Note**: If some data is empty or zero, possible reasons:\n- Item just published with insufficient sample size\n- No data available for this dimension or below statistical threshold\n- Few users in certain regions or age groups\n\n### Data Value\n- **Precise Targeting**: Understand core audience characteristics\n- **Content Optimization**: Adjust content style based on audience traits\n- **Publishing Timing**: Optimize publish time based on active periods\n- **Regional Strategy**: Customize content for main regional users\n- **Age Adaptation**: Adjust content depth and expression\n- **Gender Preference**: Understand content preferences by gender\n\n### Application Scenarios\n1. **Content Positioning**: Adjust content direction based on main audience\n2. **Publishing Optimization**: Publish during target audience active hours\n3. **Regional Marketing**: Create localized content for main regions\n4. **Age Strategy**: Adjust content complexity based on age distribution\n5. **Gender Marketing**: Balance or focus on specific gender audiences\n6. **Audience Expansion**: Identify potential audience groups to expand influence\n\n### How to get Cookie\n1. Login to Douyin Creator Platform (https://creator.douyin.com)\n2. Open browser developer tools (F12)\n3. Switch to Network tab\n4. Refresh page or perform operations\n5. Find any request and copy the Cookie header value\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_creator_v2_fetch_item_audience_portrait", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return Data Description\nReturns audience portrait data with multiple dimensions:\n\n**1. Active Distribution (active)**:\n- key: Time period identifier (\"2\"=morning, \"3\"=afternoon, \"4\"=evening, \"-1\"=other)\n- value: Active user ratio in this period (decimal between 0-1)\n\n**2. Gender Distribution (gender)**:\n- ratio_list: Gender ratio list\n - key: \"male\" or \"female\"\n - value: Gender user ratio (decimal between 0-1)\n- tgi_list: Gender TGI index list (Target Group Index)\n - key: Gender identifier\n - value: TGI value (100=average, >100=above average)\n\n**3. Region Distribution (province)**:\n- ratio_list: Province ratio list\n - key: Province name (e.g., \"浙江\", \"广东\", \"北京\")\n - value: Province user ratio (decimal between 0-1)\n- tgi_list: Province TGI index list\n - key: Province name\n - value: TGI value (reflects regional user activity)\n\n**4. Age Distribution (age)**:\n- ratio_list: Age range ratio list\n - key: Age range (\"-18\", \"18-23\", \"24-30\", \"31-40\", \"41-50\", \"50-\")\n - value: Age range user ratio (decimal between 0-1)\n- tgi_list: Age range TGI index list\n - key: Age range\n - value: TGI value (reflects age group preference)\n\n**5. Other Dimensions**:\n- career: Career distribution (may be empty)\n- city_level: City level distribution (contains ratio_list and tgi_list)\n- new_user: New user ratio (may be empty)\n\n**TGI Index Explanation**:\n- TGI = 100: Group performance matches platform average\n- TGI > 100: Group ratio is higher than platform average, core audience\n- TGI < 100: Group ratio is lower than platform average\n- Higher TGI indicates greater interest in this content type\n\n**Note**: If some data is empty or zero, possible reasons:\n- Item just published with insufficient sample size\n- No data available for this dimension or below statistical threshold\n- Few users in certain regions or age groups", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_item_audience_portrait", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "fb873e8eb918" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/creator_v2/fetch_item_audience_portrait", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_creator_v2_fetch_item_audience_portrait", "method": "POST", "path": "/apis/v1/tikhub/douyin/creator_v2/fetch_item_audience_portrait" }, "requestBody": { "content": { "application/json": { "schema": { "description": "Item audience portrait request parameters", "allOf": [ { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User's Douyin Creator Platform Cookie (required, transmitted in request body)", "example": "Your_Cookie_Here" }, "item_id": { "type": "string", "title": "Item Id", "description": "Item ID", "example": "7559536212910853422" } }, "type": "object", "required": [ "cookie", "item_id" ], "title": "ItemAudiencePortraitRequest", "description": "Item Audience Portrait Request Model" } ] }, "example": { "cookie": "Your_Cookie_Here", "item_id": "7559536212910853422" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e2b35984d9dc01817566d4be59f26ae50f62a7eb23f2df324c0d54bf14aa1473" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/douyin/creator_v2/fetch_item_audience_portrait \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"cookie\": \"Your_Cookie_Here\",\n \"item_id\": \"7559536212910853422\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-creator_v2-fetch_item_audience_portrait" } }, "/apis/v1/tikhub/douyin/creator_v2/fetch_item_danmaku_analysis": { "post": { "description": "Douyin (creator_v2).\n\n### Purpose:\n- Get Douyin item bullet (danmaku) analysis data\n- Understand audience bullet interaction at various video time points\n- Help creators identify hot segments and audience reactions\n- **This API requires users to provide valid Douyin Creator Platform Cookie**\n- **Use POST method, Cookie is transmitted in request body, more secure**\n\n### Request Body Parameters:\n- cookie: User's Douyin Creator Platform Cookie (required, transmitted in request body)\n- item_id: Item ID (required)\n\n### Return Data Description:\nReturns item bullet analysis data, including:\n- bullet_distribution: Bullet distribution data\n - time_point: Time point (seconds)\n - count: Number of bullets at this time point\n - percentage: Percentage of bullets at this time point\n- hot_words: Popular bullet words\n - word: Bullet word\n - count: Occurrence count\n - sentiment: Sentiment orientation (positive/negative/neutral)\n- total_count: Total bullet count\n- peak_time: Peak time point for bullets\n\n**Note**: If empty data or zero bullets returned, it means there is currently no bullet data for this item, possible reasons:\n- Item was just published and no viewers have sent bullets yet\n- Item type is not suitable for bullet interaction\n- Bullet feature is not enabled\n\n### Data Value:\n- **Hot Spot Identification**: Identify video segments with highest audience interest\n- **Sentiment Analysis**: Understand audience emotional reactions to content\n- **Interaction Optimization**: Optimize content presentation in high-bullet areas\n- **Content Improvement**: Adjust future content based on bullet feedback\n\n### Application Scenarios:\n1. **Content Optimization**: Find favorite segments and reinforce similar content\n2. **Pacing Adjustment**: Dense bullet areas indicate engaging content, extend similar segments\n3. **Emotion Control**: Understand genuine audience reactions through bullet sentiment\n4. **Interaction Design**: Design interactive elements at bullet peaks to boost engagement\n\n### How to get Cookie:\n1. Login to Douyin Creator Platform (https://creator.douyin.com)\n2. Open browser developer tools (F12)\n3. Switch to Network tab\n4. Refresh page or perform operations\n5. Find any request and copy the Cookie header value\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_creator_v2_fetch_item_danmaku_analysis", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return Data Description\nReturns item bullet analysis data, including:\n- bullet_distribution: Bullet distribution data\n - time_point: Time point (seconds)\n - count: Number of bullets at this time point\n - percentage: Percentage of bullets at this time point\n- hot_words: Popular bullet words\n - word: Bullet word\n - count: Occurrence count\n - sentiment: Sentiment orientation (positive/negative/neutral)\n- total_count: Total bullet count\n- peak_time: Peak time point for bullets\n\n**Note**: If empty data or zero bullets returned, it means there is currently no bullet data for this item, possible reasons:\n- Item was just published and no viewers have sent bullets yet\n- Item type is not suitable for bullet interaction\n- Bullet feature is not enabled", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_item_danmaku_analysis", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "0ab9f5faf65b" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/creator_v2/fetch_item_danmaku_analysis", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_creator_v2_fetch_item_danmaku_analysis", "method": "POST", "path": "/apis/v1/tikhub/douyin/creator_v2/fetch_item_danmaku_analysis" }, "requestBody": { "content": { "application/json": { "schema": { "description": "Item bullet (danmaku) analysis request parameters", "allOf": [ { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User's Douyin Creator Platform Cookie (required, transmitted in request body)", "example": "Your_Cookie_Here" }, "item_id": { "type": "string", "title": "Item Id", "description": "Item ID", "example": "7559536212910853422" } }, "type": "object", "required": [ "cookie", "item_id" ], "title": "ItemBulletAnalysisRequest", "description": "Item Bullet Analysis Request Model" } ] }, "example": { "cookie": "Your_Cookie_Here", "item_id": "7559536212910853422" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:2276a7568ceeae3b4fb180cc1cad8625a6d0ffe4a07191c62f210473d34ecb31" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/douyin/creator_v2/fetch_item_danmaku_analysis \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"cookie\": \"Your_Cookie_Here\",\n \"item_id\": \"7559536212910853422\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-creator_v2-fetch_item_danmaku_analysis" } }, "/apis/v1/tikhub/douyin/creator_v2/fetch_item_list": { "post": { "description": "Douyin (creator_v2).\n\n### Purpose\n- Get all published items within the specified time range\n- Support pagination query, maximum 100 items per request\n- Data update description:\n - **Views, likes, comments, shares, favorites update in real-time**\n - **Other metrics update hourly**\n- **This API requires users to provide valid Douyin Creator Platform Cookie**\n- **Use POST method, Cookie is transmitted in request body, more secure**\n\n### Request Body Parameters\n- cookie: User's Douyin Creator Platform Cookie (required, transmitted in request body)\n- start_time: Start timestamp in milliseconds (required)\n- end_time: End timestamp in milliseconds (required)\n- count: Number of items per page, default 10, max 100 (optional)\n- order_by: Sort method, supports 26 types (optional, default 1)\n- fields: 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\n- need_cooperation: Need cooperation info, default true (optional)\n- need_long_article: Include long articles, default true (optional)\n- cursor: Pagination cursor, don't pass for first request, use returned cursor for pagination (optional)\n\n### Sort Options (order_by)\n| Value | Sort Field | Direction | Update Freq | Description |\n|-------|-----------|-----------|-------------|-------------|\n| 1 | Publish Time | Desc ↓ | - | Default, newest first |\n| 2 | Publish Time | Asc ↑ | - | Oldest first |\n| 3 | Views | Desc ↓ | Real-time | Video views count |\n| 4 | Views | Asc ↑ | Real-time | Least views first |\n| 5 | Likes | Desc ↓ | Real-time | Likes count |\n| 6 | Likes | Asc ↑ | Real-time | Least likes first |\n| 7 | Comments | Desc ↓ | Real-time | Comments count |\n| 8 | Comments | Asc ↑ | Real-time | Least comments first |\n| 9 | Shares | Desc ↓ | Real-time | Shares count |\n| 10 | Shares | Asc ↑ | Real-time | Least shares first |\n| 11 | Favorites | Desc ↓ | Real-time | Favorites count |\n| 12 | Favorites | Asc ↑ | Real-time | Least favorites first |\n| 13 | 2s Bounce Rate | Desc ↓ | Hourly | Views bounced within 2s / total views |\n| 14 | 2s Bounce Rate | Asc ↑ | Hourly | Lowest bounce rate first |\n| 15 | 5s Completion | Desc ↓ | Hourly | Views over 5s / total views |\n| 16 | 5s Completion | Asc ↑ | Hourly | Lowest 5s completion first |\n| 17 | Completion Rate | Desc ↓ | Hourly | Full plays / total views |\n| 18 | Completion Rate | Asc ↑ | Hourly | Lowest completion rate first |\n| 19 | Cover CTR | Desc ↓ | Hourly | Cover clicks / cover impressions |\n| 20 | Cover CTR | Asc ↑ | Hourly | Lowest CTR first |\n| 21 | Avg Play Duration | Desc ↓ | Hourly | Average video play duration |\n| 22 | Avg Play Duration | Asc ↑ | Hourly | Shortest duration first |\n| 23 | Profile Visits | Desc ↓ | Daily | Profile visits after watching |\n| 24 | Profile Visits | Asc ↑ | Daily | Least profile visits first |\n| 25 | Follower Growth | Desc ↓ | Hourly | New followers from this video |\n| 26 | Follower Growth | Asc ↑ | Hourly | Least follower growth first |\n\n### Sort Usage Tips\n- **Find Hits**: Use order_by=3 (Views↓) or order_by=5 (Likes↓)\n- **Content Optimization**: Use order_by=13 (Bounce Rate↓) to find videos to improve\n- **Improve Completion**: Use order_by=17 (Completion↓) to analyze high-completion videos\n- **Follower Analysis**: Use order_by=25 (Follower Growth↓) to find best performing videos\n- **Cover Optimization**: Use order_by=19 (Cover CTR↓) to analyze cover attractiveness\n\n### Return\n- Item list data with detailed metric information\n- has_more: Whether there are more items\n- cursor: Cursor for next page, used for pagination\n- items: Array of items\n\n### Usage Flow\n1. **First request**: Don't pass cursor parameter, get first page\n2. **Check has_more**: If true, there are more items\n3. **Paginate**: Use returned cursor value as cursor parameter for next request\n4. **Repeat steps 2-3**: Until has_more is false\n\n### Limitations\n- Only supports filtering: Top 100 items by genre in selected period\n- For exporting more data, use `/tikhub/douyin/creator_v2/fetch_item_list_download` API (supports top 1000 items)\n\n### Timestamp Conversion\n- JavaScript: `new Date('2025-07-01').getTime()` -> 1719763200000\n- Python: `int(datetime(2025, 7, 1).timestamp() * 1000)` -> 1719763200000\n\n### How to get Cookie\n1. Login to Douyin Creator Platform (https://creator.douyin.com)\n2. Open browser developer tools (F12)\n3. Switch to Network tab\n4. Refresh page or perform operations\n5. Find any request and copy the Cookie header value\n\nAPI references: `fetch_item_list_download` = `POST /tikhub/douyin/creator_v2/fetch_item_list_download` (operationId: `post_tikhub_douyin_creator_v2_fetch_item_list_download`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_creator_v2_fetch_item_list", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Item list data with detailed metric information\n- has_more: Whether there are more items\n- cursor: Cursor for next page, used for pagination\n- items: Array of items", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_item_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "64ce08445e77" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/creator_v2/fetch_item_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_creator_v2_fetch_item_list", "method": "POST", "path": "/apis/v1/tikhub/douyin/creator_v2/fetch_item_list" }, "requestBody": { "content": { "application/json": { "schema": { "description": "Item list request parameters", "allOf": [ { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User's Douyin Creator Platform Cookie (required, transmitted in request body)", "example": "Your_Cookie_Here" }, "count": { "type": "integer", "title": "Count", "description": "Count per page (max 100)\n\nUsage: Number of items per page, default 10, max 100 (optional)", "default": 10, "example": 10, "maximum": 100 }, "order_by": { "type": "integer", "title": "Order By", "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)", "default": 1, "example": 1 }, "fields": { "type": "string", "title": "Fields", "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", "default": "metrics,review,visibility", "example": "metrics,review,visibility" }, "need_cooperation": { "type": "boolean", "title": "Need Cooperation", "description": "Need cooperation info", "default": true, "example": true }, "start_time": { "type": "integer", "title": "Start Time", "description": "Start timestamp (milliseconds)", "example": 1758988800000 }, "end_time": { "type": "integer", "title": "End Time", "description": "End time timestamp (milliseconds)", "example": 1760198399000 }, "need_long_article": { "type": "boolean", "title": "Need Long Article", "description": "Include long articles", "default": true, "example": true }, "cursor": { "title": "Cursor", "description": "Pagination cursor, don't pass for first request, use returned cursor for pagination (optional)", "type": [ "integer", "null" ] } }, "type": "object", "required": [ "cookie", "start_time", "end_time" ], "title": "ItemListRequest", "description": "Item List Request Model" } ] }, "example": { "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 } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:b29ccd0f6a54ad8bcb6d2b9e48496db52e19d9e6efb6f6a4874d83a9ddddf648" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/douyin/creator_v2/fetch_item_list \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"cookie\": \"Your_Cookie_Here\",\n \"start_time\": 1758988800000,\n \"end_time\": 1760198399000,\n \"count\": 10,\n \"order_by\": 1,\n \"fields\": \"metrics,review,visibility\",\n \"need_cooperation\": true,\n \"need_long_article\": true\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-creator_v2-fetch_item_list" } }, "/apis/v1/tikhub/douyin/creator_v2/fetch_item_list_download": { "post": { "description": "Douyin (creator_v2).\n\n### Purpose\n- Export detailed data of top 1000 items within the specified time range\n- Support filtering export content by genre types\n- **This API is for batch export, not suitable for real-time queries**\n- **Export tasks are processed asynchronously, need to wait for server to generate file**\n- **This API requires users to provide valid Douyin Creator Platform Cookie**\n- **Use POST method, Cookie is transmitted in request body, more secure**\n\n### Request Body Parameters\n- cookie: User's Douyin Creator Platform Cookie (required, transmitted in request body)\n- min_cursor: Min cursor, i.e., start timestamp in milliseconds (required)\n- max_cursor: Max cursor, i.e., end timestamp in milliseconds (required)\n- type_filters: Genre type filter list, default all [1,2,3,4,5,8] (optional)\n - **1**: Videos under 1 minute\n - **2**: 1-3 minute videos\n - **3**: 3-5 minute videos\n - **4**: Videos over 5 minutes\n - **5**: Image posts\n - **8**: Long image posts\n- need_long_article: Include long articles, default true (optional)\n\n### Return\n- **Directly returns Excel file stream**, browser will auto-download\n- File: Excel workbook (.xlsx); use the filename supplied by the response\n- File Format: Excel (.xlsx)\n- Content-Type: application/vnd.ms-excel\n\n### Usage Flow\n1. **Initiate export request**: Submit time range and filter conditions\n2. **Receive file**: API returns Excel file stream directly\n3. **Auto download**: Browser automatically triggers file download\n4. **Data analysis**: Open Excel file for data analysis\n\n### Limitations\n- Only supports exporting: Top 1000 items in selected period\n- Support filtering by genre types (can select any combination of 1-6 genres)\n- Not suitable for real-time queries, designed for batch data analysis\n\n### Genre Type Description\n| Type | Genre Name | Description | Use Case |\n|------|-----------|-------------|----------|\n| 1 | <1min video | Short video | Fast spread, high engagement |\n| 2 | 1-3min video | Medium-short video | Balance content & duration |\n| 3 | 3-5min video | Medium-long video | Deep content presentation |\n| 4 | 5min+ video | Long video | Professional content, deep analysis |\n| 5 | Image post | Image post | Picture + text format |\n| 8 | Long image post | Long image post | Deep image-text content |\n\n### Export Data Includes\n- Item basic info (ID, title, publish time, etc.)\n- Traffic metrics (views, likes, comments, shares, favorites)\n- Review status\n- Visibility settings\n- Other creator-related data\n\n### Timestamp Conversion\n- JavaScript: `new Date('2025-07-01').getTime()` -> 1719763200000\n- Python: `int(datetime(2025, 7, 1).timestamp() * 1000)` -> 1719763200000\n\n### How to get Cookie\n1. Login to Douyin Creator Platform (https://creator.douyin.com)\n2. Open browser developer tools (F12)\n3. Switch to Network tab\n4. Refresh page or perform operations\n5. Find any request and copy the Cookie header value\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_creator_v2_fetch_item_list_download", "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_item_list_download", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "efca6c5ca813" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/creator_v2/fetch_item_list_download", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_creator_v2_fetch_item_list_download", "method": "POST", "path": "/apis/v1/tikhub/douyin/creator_v2/fetch_item_list_download" }, "requestBody": { "content": { "application/json": { "schema": { "description": "Item list download request parameters", "allOf": [ { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User's Douyin Creator Platform Cookie (required, transmitted in request body)", "example": "Your_Cookie_Here" }, "min_cursor": { "type": "integer", "title": "Min Cursor", "description": "Min cursor (start timestamp in milliseconds)", "example": 1752336000000 }, "max_cursor": { "type": "integer", "title": "Max Cursor", "description": "Max cursor (end timestamp in milliseconds)", "example": 1760198399000 }, "type_filters": { "items": { "type": "integer" }, "type": "array", "title": "Type Filters", "description": "Type filters: 1=video under 1 min, 2=1-3 min video, 3=3-5 min video, 4=video over 5 min, 5=image+text, 8=long-form article\n\nUsage: Genre type filter list, default all [1,2,3,4,5,8] (optional)\n - **1**: Videos under 1 minute\n - **2**: 1-3 minute videos\n - **3**: 3-5 minute videos\n - **4**: Videos over 5 minutes\n - **5**: Image posts\n - **8**: Long image posts", "default": [ 1, 2, 3, 4, 5, 8 ], "example": [ 2, 3, 4, 5, 1, 8 ] }, "need_long_article": { "type": "boolean", "title": "Need Long Article", "description": "Include long articles", "default": true, "example": true } }, "type": "object", "required": [ "cookie", "min_cursor", "max_cursor" ], "title": "ItemListDownloadRequest", "description": "Item List Download Request Model" } ] }, "example": { "cookie": "Your_Cookie_Here", "min_cursor": 1752336000000, "max_cursor": 1760198399000, "type_filters": [ 2, 3, 4, 5, 1, 8 ], "need_long_article": true } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-pending": { "operation_id": "post_tikhub_douyin_creator_v2_fetch_item_list_download", "path": "/apis/v1/tikhub/douyin/creator_v2/fetch_item_list_download", "method": "POST", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/douyin/creator_v2/fetch_item_list_download \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"cookie\": \"Your_Cookie_Here\",\n \"min_cursor\": 1752336000000,\n \"max_cursor\": 1760198399000,\n \"type_filters\": [\n 2,\n 3,\n 4,\n 5,\n 1,\n 8\n ],\n \"need_long_article\": true\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-creator_v2-fetch_item_list_download" } }, "/apis/v1/tikhub/douyin/creator_v2/fetch_item_overview_data": { "post": { "description": "Douyin (creator_v2).\n\n### Purpose:\n- Get Douyin item overview data, including traffic metrics, review status, play info, etc.\n- **This API requires users to provide valid Douyin Creator Platform Cookie**\n- **Use POST method, Cookie is transmitted in request body, more secure**\n\n### Request Body Parameters:\n- cookie: User's Douyin Creator Platform Cookie (required, transmitted in request body)\n- ids: Item ID list, separated by comma (e.g., \"7559536212910853422,7559536212910853423\")\n- fields: Fields to return, default is \"metrics,review,play_info,dou_plus,integrated_incentive,incentive_life,content_analysis\"\n - Available fields (comma-separated, customizable):\n - metrics: Traffic metrics data (views, likes, comments, etc.)\n - review: Review status information\n - play_info: Play related information\n - dou_plus: DOU+ promotion information\n - integrated_incentive: Integrated incentive data\n - incentive_life: Incentive lifecycle information\n - content_analysis: Content analysis data\n\n### Return:\n- Item overview data, returns corresponding fields based on the fields parameter\n\n### How to get Cookie:\n1. Login to Douyin Creator Platform (https://creator.douyin.com)\n2. Open browser developer tools (F12)\n3. Switch to Network tab\n4. Refresh page or perform operations\n5. Find any request and copy the Cookie header value\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_creator_v2_fetch_item_overview_data", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Item overview data, returns corresponding fields based on the fields parameter", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_item_overview_data", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "d18a8ea81081" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/creator_v2/fetch_item_overview_data", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_creator_v2_fetch_item_overview_data", "method": "POST", "path": "/apis/v1/tikhub/douyin/creator_v2/fetch_item_overview_data" }, "requestBody": { "content": { "application/json": { "schema": { "description": "Item overview data request parameters", "allOf": [ { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User's Douyin Creator Platform Cookie (required, transmitted in request body)", "example": "Your_Cookie_Here" }, "ids": { "type": "string", "title": "Ids", "description": "Item ID list, separated by comma (e.g., \"7559536212910853422,7559536212910853423\")", "example": "7559536212910853422,7559536212910853423" }, "fields": { "title": "Fields", "description": "Fields to return, separated by comma. Optional values: metrics, review, play_info, dou_plus, integrated_incentive, incentive_life, content_analysis\n\nUsage: Fields to return, default is \"metrics,review,play_info,dou_plus,integrated_incentive,incentive_life,content_analysis\"\n - Available fields (comma-separated, customizable):\n - metrics: Traffic metrics data (views, likes, comments, etc.)\n - review: Review status information\n - play_info: Play related information\n - dou_plus: DOU+ promotion information\n - integrated_incentive: Integrated incentive data\n - incentive_life: Incentive lifecycle information\n - content_analysis: Content analysis data", "default": "metrics,review,play_info,dou_plus,integrated_incentive,incentive_life,content_analysis", "type": [ "string", "null" ] } }, "type": "object", "required": [ "cookie", "ids" ], "title": "ItemMgetRequest", "description": "Item Overview Data Request Model" } ] }, "example": { "cookie": "Your_Cookie_Here", "ids": "7559536212910853422", "fields": "metrics,review,play_info,dou_plus,integrated_incentive,incentive_life,content_analysis" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:c8e3ed94ff9c7d71bbe9ecc2bf32d7a70763ef1d11225b04c41582e864a88a68" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/douyin/creator_v2/fetch_item_overview_data \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"cookie\": \"Your_Cookie_Here\",\n \"ids\": \"7559536212910853422\",\n \"fields\": \"metrics,review,play_info,dou_plus,integrated_incentive,incentive_life,content_analysis\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-creator_v2-fetch_item_overview_data" } }, "/apis/v1/tikhub/douyin/creator_v2/fetch_item_play_source": { "post": { "description": "Douyin (creator_v2).\n\n### Purpose:\n- Get Douyin item play source statistics\n- Statistics of the proportion of item views from different sources\n- **If a channel is not shown, it means there are no views from that channel yet**\n- **For newly published items, the recommended page traffic may be low initially, please wait for system distribution**\n- **This API requires users to provide valid Douyin Creator Platform Cookie**\n- **Use POST method, Cookie is transmitted in request body, more secure**\n\n### Request Body Parameters:\n- cookie: User's Douyin Creator Platform Cookie (required, transmitted in request body)\n- item_id: Item ID (required)\n\n### Return Data Description:\n- play_source: List of traffic sources with play proportion for each channel\n - key: Traffic source channel identifier\n - value: Current proportion (decimal between 0-1, e.g., 0.85 means 85%)\n - history_difference: Difference from historical data\n - app_id: Application ID\n\n### Traffic Source Channel Description:\n- **homepage_hot**: Recommended page (system recommendation traffic)\n- **familiar**: Friends page (followed people, friend recommendations)\n- **search**: Search (user active search)\n- **homepage**: Personal homepage (views from homepage visits)\n- **message**: Message page (through message entry)\n- **other**: Other (other sources)\n\n### How to get Cookie:\n1. Login to Douyin Creator Platform (https://creator.douyin.com)\n2. Open browser developer tools (F12)\n3. Switch to Network tab\n4. Refresh page or perform operations\n5. Find any request and copy the Cookie header value\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_creator_v2_fetch_item_play_source", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return Data Description\n- play_source: List of traffic sources with play proportion for each channel\n - key: Traffic source channel identifier\n - value: Current proportion (decimal between 0-1, e.g., 0.85 means 85%)\n - history_difference: Difference from historical data\n - app_id: Application ID", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_item_play_source", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "63415e872189" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/creator_v2/fetch_item_play_source", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_creator_v2_fetch_item_play_source", "method": "POST", "path": "/apis/v1/tikhub/douyin/creator_v2/fetch_item_play_source" }, "requestBody": { "content": { "application/json": { "schema": { "description": "Item play source statistics request parameters", "allOf": [ { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User's Douyin Creator Platform Cookie (required, transmitted in request body)", "example": "Your_Cookie_Here" }, "item_id": { "type": "string", "title": "Item Id", "description": "Item ID", "example": "7559536212910853422" } }, "type": "object", "required": [ "cookie", "item_id" ], "title": "ItemPlaySourceRequest", "description": "Item Play Source Statistics Request Model" } ] }, "example": { "cookie": "Your_Cookie_Here", "item_id": "7559536212910853422" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:5c65b0e7cf59a165b30e2f4c8f84d6f1822ba79bcb901476b8536840e4dfe018" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/douyin/creator_v2/fetch_item_play_source \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"cookie\": \"Your_Cookie_Here\",\n \"item_id\": \"7559536212910853422\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-creator_v2-fetch_item_play_source" } }, "/apis/v1/tikhub/douyin/creator_v2/fetch_item_search_keyword": { "post": { "description": "Douyin (creator_v2).\n\n### Purpose:\n- Get Douyin item search keywords statistics\n- Understand which search keywords users used to find and watch the item\n- Help creators optimize content titles, tags, and descriptions to improve search exposure\n- **This API requires users to provide valid Douyin Creator Platform Cookie**\n- **Use POST method, Cookie is transmitted in request body, more secure**\n\n### Request Body Parameters:\n- cookie: User's Douyin Creator Platform Cookie (required, transmitted in request body)\n- item_id: Item ID (required)\n\n### Return Data Description:\nReturns a list of keywords users searched for to find this item, including:\n- keyword: Search keyword\n- count: Number of times this keyword was searched\n- percentage: Percentage of this keyword in total searches\n\n**Note**: If an empty list is returned, it means there is currently no search keyword data for this item, possible reasons:\n- Item was just published and no users have searched for it yet\n- Item is mainly spread through recommendations, follows, etc., not through search\n- No search behavior during the statistics period\n\n### Data Value:\n- **Optimize Title**: Adjust item title based on popular keywords\n- **Optimize Tags**: Add relevant popular search terms as tags\n- **Content Planning**: Understand user interests and create more relevant content\n- **SEO Optimization**: Improve item ranking in search results\n\n### How to get Cookie:\n1. Login to Douyin Creator Platform (https://creator.douyin.com)\n2. Open browser developer tools (F12)\n3. Switch to Network tab\n4. Refresh page or perform operations\n5. Find any request and copy the Cookie header value\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_creator_v2_fetch_item_search_keyword", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return Data Description\nReturns a list of keywords users searched for to find this item, including:\n- keyword: Search keyword\n- count: Number of times this keyword was searched\n- percentage: Percentage of this keyword in total searches\n\n**Note**: If an empty list is returned, it means there is currently no search keyword data for this item, possible reasons:\n- Item was just published and no users have searched for it yet\n- Item is mainly spread through recommendations, follows, etc., not through search\n- No search behavior during the statistics period", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_item_search_keyword", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "44c27034e134" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/creator_v2/fetch_item_search_keyword", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_creator_v2_fetch_item_search_keyword", "method": "POST", "path": "/apis/v1/tikhub/douyin/creator_v2/fetch_item_search_keyword" }, "requestBody": { "content": { "application/json": { "schema": { "description": "Item search keywords statistics request parameters", "allOf": [ { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User's Douyin Creator Platform Cookie (required, transmitted in request body)", "example": "Your_Cookie_Here" }, "item_id": { "type": "string", "title": "Item Id", "description": "Item ID", "example": "7559536212910853422" } }, "type": "object", "required": [ "cookie", "item_id" ], "title": "ItemSearchKeywordRequest", "description": "Item Search Keywords Request Model" } ] }, "example": { "cookie": "Your_Cookie_Here", "item_id": "7559536212910853422" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:ceb1ca31b7b7a3a5be27b340fcb3f223e748e05754885fbf03e34ff46595a06d" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/douyin/creator_v2/fetch_item_search_keyword \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"cookie\": \"Your_Cookie_Here\",\n \"item_id\": \"7559536212910853422\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-creator_v2-fetch_item_search_keyword" } }, "/apis/v1/tikhub/douyin/creator_v2/fetch_item_watch_trend": { "post": { "description": "Douyin (creator_v2).\n\n### Purpose:\n- Get Douyin item watch trend analysis data\n- Understand user behavior patterns while watching the item\n- Help creators optimize video content structure and pacing\n- **This API requires users to provide valid Douyin Creator Platform Cookie**\n- **Use POST method, Cookie is transmitted in request body, more secure**\n\n### Request Body Parameters:\n- cookie: User's Douyin Creator Platform Cookie (required, transmitted in request body)\n- item_id: Item ID (required)\n- analysis_type: Analysis type (optional, default is 1)\n - **1**: Retention Analysis - Shows user retention at each time point\n - **2**: Like Analysis - Shows user like behavior at each time point\n - **7**: Bounce Analysis - Shows user bounce rate at each time point\n\n### Analysis Type Description:\n- **Retention Analysis (analysis_type=1)**:\n - Shows viewer retention rate at various video time points\n - Higher retention means more engaging content at that moment\n - **Note**: Data is more accurate when views exceed 200\n - Good for: Identifying which segments keep viewers watching\n\n- **Like Analysis (analysis_type=2)**:\n - Shows viewer like rate at various video time points\n - Higher like rate indicates particularly popular segments\n - Good for: Identifying segments that drive user engagement\n\n- **Bounce Analysis (analysis_type=7)**:\n - Shows viewer bounce rate at various video time points\n - High bounce rate indicates potential content issues\n - Good for: Identifying segments that cause viewers to leave\n\n### Return Data Description:\n- analysis_trend: Trend analysis data\n - current_item: Data points for current item\n - key: Time point (format: mm:ss, e.g., \"00:05\" for 5 seconds)\n - value: Proportion at this time point (decimal between 0-1)\n - similar_author: Average data from similar authors (for comparison)\n - key: Time point\n - value: Average proportion at this time point\n\n### Data Value:\n- **Content Optimization**: Identify key drop-off points\n- **Pacing Adjustment**: Optimize video rhythm and flow\n- **Comparative Analysis**: Compare with similar creators to find gaps\n- **A/B Testing**: Test different content versions\n\n### How to get Cookie:\n1. Login to Douyin Creator Platform (https://creator.douyin.com)\n2. Open browser developer tools (F12)\n3. Switch to Network tab\n4. Refresh page or perform operations\n5. Find any request and copy the Cookie header value\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_creator_v2_fetch_item_watch_trend", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return Data Description\n- analysis_trend: Trend analysis data\n - current_item: Data points for current item\n - key: Time point (format: mm:ss, e.g., \"00:05\" for 5 seconds)\n - value: Proportion at this time point (decimal between 0-1)\n - similar_author: Average data from similar authors (for comparison)\n - key: Time point\n - value: Average proportion at this time point", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_item_watch_trend", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "98a247e2dc16" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/creator_v2/fetch_item_watch_trend", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_creator_v2_fetch_item_watch_trend", "method": "POST", "path": "/apis/v1/tikhub/douyin/creator_v2/fetch_item_watch_trend" }, "requestBody": { "content": { "application/json": { "schema": { "description": "Item watch trend analysis request parameters", "allOf": [ { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User's Douyin Creator Platform Cookie (required, transmitted in request body)", "example": "Your_Cookie_Here" }, "item_id": { "type": "string", "title": "Item Id", "description": "Item ID", "example": "7559536212910853422" }, "analysis_type": { "type": "integer", "title": "Analysis Type", "description": "Analysis type: 1=Retention, 2=Like, 7=Bounce\n\nUsage: Analysis type (optional, default is 1)\n - **1**: Retention Analysis - Shows user retention at each time point\n - **2**: Like Analysis - Shows user like behavior at each time point\n - **7**: Bounce Analysis - Shows user bounce rate at each time point", "default": 1, "example": 1 } }, "type": "object", "required": [ "cookie", "item_id" ], "title": "ItemWatchTrendRequest", "description": "Item Watch Trend Analysis Request Model" } ] }, "example": { "cookie": "Your_Cookie_Here", "item_id": "7559536212910853422", "analysis_type": 1 } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:49956302f5c7ca34c8de6f0bbe8efcb648bd7d4e87b5d56878e3d47370939c1e" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/douyin/creator_v2/fetch_item_watch_trend \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"cookie\": \"Your_Cookie_Here\",\n \"item_id\": \"7559536212910853422\",\n \"analysis_type\": 1\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-creator_v2-fetch_item_watch_trend" } }, "/apis/v1/tikhub/douyin/creator_v2/fetch_live_room_history_list": { "post": { "description": "Douyin (creator_v2).\n\n### Purpose:\n- Get Douyin creator's live room history list\n- View all live session data within a specified time range\n- Support querying ongoing and historical live sessions\n- **This API requires users to provide valid Douyin Creator Platform Cookie**\n- **Use POST method, Cookie is transmitted in request body, more secure**\n\n### Request Body Parameters:\n- cookie: User's Douyin Creator Platform Cookie (required, transmitted in request body)\n- start_date: Start date in YYYY-MM-DD format (required, e.g., \"2025-09-11\")\n- end_date: End date in YYYY-MM-DD format (required, e.g., \"2025-10-11\")\n- limit: Limit per page, default 400, max 400\n- need_living: Include ongoing live sessions (0=No, 1=Yes, default 1)\n- download: Download flag (0=No download, 1=Download, default 0)\n\n### Return Data Description:\nReturns a list of live session history, data is located in `data.data.series` array, each session includes:\n\n**Basic Info**:\n- roomID: Live room ID\n- roomTitle: Live title\n- coverUri: Live cover image URL\n- startTime: Start time (format: \"YYYY-MM-DD HH:mm:ss\")\n- endTime: End time (format: \"YYYY-MM-DD HH:mm:ss\")\n- liveDurationWithoutPause: Duration without pause (format: \"1 minute 5 seconds\")\n- playStatus: Play status (4=Ended)\n\n**Traffic Data**:\n- watchCnt: Total watch count\n- serverWatchUcntTdDirect: Direct watch user count (from server statistics)\n- pcu: Peak Concurrent Users\n- liveServerWatchDurationTdPavg: Average watch duration\n\n**Engagement Data**:\n- serverLikeCntTd: Likes count\n- clientCommentUcntTd: Comment user count\n- liveNewFollowUcnt: New followers count\n\n**Consumption/Conversion Data**:\n- liveConsumeUcnt: Consuming user count\n- liveFansConsumeUcntTd: Fan consuming user count\n- roomLiveEarnScore: Live room earn score\n\n### Data Value:\n- **History Review**: View complete records of all live sessions\n- **Data Comparison**: Compare performance across sessions\n- **Trend Analysis**: Analyze changes in live performance\n- **Optimization**: Identify common traits of high-conversion sessions\n- **Time Planning**: Optimize live timing based on historical data\n- **Content Strategy**: Adjust content based on theme performance\n\n### Use Cases:\n1. **Regular Review**: Weekly/monthly live data summary\n2. **Effect Evaluation**: Evaluate performance by time and theme\n3. **Data Reports**: Generate reports for team analysis\n4. **Strategy Optimization**: Develop strategies based on data\n5. **KPI Tracking**: Track live-related KPIs\n6. **Trend Prediction**: Predict future live performance\n\n### Notes:\n1. **Time Range**: Recommended not to exceed 3 months\n2. **Quantity Limit**: Max 400 records per request\n3. **Data Delay**: 1-2 hours delay possible\n4. **Ongoing Live**: Set need_living=1 to include current live\n5. **Cookie Validity**: Ensure Cookie is not expired\n6. **Date Format**: Must use YYYY-MM-DD format\n\n### How to get Cookie:\n1. Login to Douyin Creator Platform (https://creator.douyin.com)\n2. Open browser developer tools (F12)\n3. Switch to Network tab\n4. Refresh page or perform operations\n5. Find any request and copy the Cookie header value\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_creator_v2_fetch_live_room_history_list", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return Data Description\nReturns a list of live session history, data is located in `data.data.series` array, each session includes:\n\n**Basic Info**:\n- roomID: Live room ID\n- roomTitle: Live title\n- coverUri: Live cover image URL\n- startTime: Start time (format: \"YYYY-MM-DD HH:mm:ss\")\n- endTime: End time (format: \"YYYY-MM-DD HH:mm:ss\")\n- liveDurationWithoutPause: Duration without pause (format: \"1 minute 5 seconds\")\n- playStatus: Play status (4=Ended)\n\n**Traffic Data**:\n- watchCnt: Total watch count\n- serverWatchUcntTdDirect: Direct watch user count (from server statistics)\n- pcu: Peak Concurrent Users\n- liveServerWatchDurationTdPavg: Average watch duration\n\n**Engagement Data**:\n- serverLikeCntTd: Likes count\n- clientCommentUcntTd: Comment user count\n- liveNewFollowUcnt: New followers count\n\n**Consumption/Conversion Data**:\n- liveConsumeUcnt: Consuming user count\n- liveFansConsumeUcntTd: Fan consuming user count\n- roomLiveEarnScore: Live room earn score", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_live_room_history_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "dc44f8ecc0c4" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/creator_v2/fetch_live_room_history_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_creator_v2_fetch_live_room_history_list", "method": "POST", "path": "/apis/v1/tikhub/douyin/creator_v2/fetch_live_room_history_list" }, "requestBody": { "content": { "application/json": { "schema": { "description": "Live room history list request parameters", "allOf": [ { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User's Douyin Creator Platform Cookie (required, transmitted in request body)", "example": "Your_Cookie_Here" }, "start_date": { "type": "string", "title": "Start Date", "description": "Start date in YYYY-MM-DD format (required, e.g., \"2025-09-11\")", "example": "2025-09-11" }, "end_date": { "type": "string", "title": "End Date", "description": "End date in YYYY-MM-DD format (required, e.g., \"2025-10-11\")", "example": "2025-10-11" }, "limit": { "type": "integer", "title": "Limit", "description": "Limit per page, default 400, max 400", "default": 400, "example": 400, "maximum": 400 }, "need_living": { "type": "integer", "title": "Need Living", "description": "Include live rooms currently streaming: 0=exclude, 1=include", "default": 1, "example": 1 }, "download": { "type": "integer", "title": "Download", "description": "Download: 0=no download, 1=download\n\nUsage: Download flag (0=No download, 1=Download, default 0)", "default": 0, "example": 0 } }, "type": "object", "required": [ "cookie", "start_date", "end_date" ], "title": "LiveRoomHistoryListRequest", "description": "Live Room History List Request Model" } ] }, "example": { "cookie": "Your_Cookie_Here", "start_date": "2025-09-11", "end_date": "2025-10-11", "limit": 400, "need_living": 1, "download": 0 } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:0753764e33cb968497797c37e1d88710dfc3e281a19ca86cdf4d8b83e62422b1" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/douyin/creator_v2/fetch_live_room_history_list \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"cookie\": \"Your_Cookie_Here\",\n \"start_date\": \"2025-09-11\",\n \"end_date\": \"2025-10-11\",\n \"limit\": 400,\n \"need_living\": 1,\n \"download\": 0\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-creator_v2-fetch_live_room_history_list" } }, "/apis/v1/tikhub/douyin/douplus/calculate_cost": { "post": { "description": "Douyin (douplus).\n\n### Purpose:\n- DOU+ cost estimation: given delivery account + item(s) + target, return budget combos / price / estimate\n- **Requires a valid www.douyin.com web Cookie**\n### Parameters:\n- cookie: User's www.douyin.com web Cookie (required)\n- sec_uid: sec_uid of the delivery account (required)\n- item_ids: Item id(s), comma separated (required)\n- target_id: Promotion target id, default 31. 31=likes&comments, 32=fans, 33=homepage views, 37=video plays, 45=comment-link clicks, 78=high-quality interaction\n### Return:\n- Budget combos / price / estimated results\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_douplus_calculate_cost", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Budget combos / price / estimated results", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin calculate_cost", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "3a99a6ea9b43" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/douplus/calculate_cost", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_douplus_calculate_cost", "method": "POST", "path": "/apis/v1/tikhub/douyin/douplus/calculate_cost" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User www.douyin.com web Cookie", "example": "Your_Cookie_Here" }, "sec_uid": { "type": "string", "title": "Sec Uid", "description": "Delivery account sec_uid", "example": "MS4wLjABAAAA9fe7vGjwyiaOjL6REhX8rvmSb32VzA_XsKca9F3_YSHRXlEqgT2cpX54WGbtgnsA" }, "item_ids": { "type": "string", "title": "Item Ids", "description": "Item ID(s), comma separated", "example": "7651166972160446949" }, "target_id": { "title": "Target Id", "description": "Promotion target ID. 31=Likes & Comments, 32=Followers, 33=Profile visits, 37=Video views, 45=Comment link clicks, 78=High-quality engagement", "default": 31, "example": 31, "type": [ "integer", "null" ] } }, "type": "object", "required": [ "cookie", "sec_uid", "item_ids" ], "title": "CostEstimateRequest", "description": "DOU+ Cost Estimation Request Model" }, "example": { "cookie": "Your_Cookie_Here", "sec_uid": "MS4wLjABAAAA9fe7vGjwyiaOjL6REhX8rvmSb32VzA_XsKca9F3_YSHRXlEqgT2cpX54WGbtgnsA", "item_ids": "7651166972160446949", "target_id": 31 } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:7a430b76eca362e57b5ea089aad04b39bf0433c14a7fd6590ff9ce62144e8748" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/douyin/douplus/calculate_cost \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"cookie\": \"Your_Cookie_Here\",\n \"sec_uid\": \"MS4wLjABAAAA9fe7vGjwyiaOjL6REhX8rvmSb32VzA_XsKca9F3_YSHRXlEqgT2cpX54WGbtgnsA\",\n \"item_ids\": \"7651166972160446949\",\n \"target_id\": 31\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-douplus-calculate_cost" } }, "/apis/v1/tikhub/douyin/douplus/fetch_analyse_detail": { "post": { "description": "Douyin (douplus).\n\n### Purpose\n- DOU+ delivery analysis detail (per-order / per-item metric list with paging & sorting); account/video/live by query.analysisType\n- **Requires a valid www.douyin.com web Cookie**\n\n### Parameters (query passthrough)\n- Same fields as overview, plus page, limit, orderByMetric (e.g. create_time), orderByType\n\n### Return\n- Detail list data (with pagination)\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_douplus_fetch_analyse_detail", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Detail list data (with pagination)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_analyse_detail", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "190927fd7ea0" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/douplus/fetch_analyse_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_douplus_fetch_analyse_detail", "method": "POST", "path": "/apis/v1/tikhub/douyin/douplus/fetch_analyse_detail" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User www.douyin.com web Cookie", "example": "Your_Cookie_Here" }, "query": { "additionalProperties": true, "type": "object", "title": "Query", "description": "Analysis query object. Key fields: startTime, endTime (second timestamp string); analysisType (1=account, 2=video, 3=live); authorSecIdList (account sec_uid list); statusList (delivery status filter); metrics (metric list, e.g. stat_cost, total_play, total_like, dy_comment, dy_share, dy_follow); SecondaryTargetIds; CollectWayIds. graph extra: dimension; detail extra: page, limit, orderByMetric, orderByType; video/live extra: liveRoomIdList", "example": { "CollectWayIds": [], "SecondaryTargetIds": [], "analysisType": 1, "authorSecIdList": [], "endTime": "1781625599", "metrics": [ "stat_cost", "total_play", "play_duration_5s_rate", "total_like", "dy_comment", "dy_share", "dy_home_visited", "dy_follow" ], "startTime": "1780934400", "statusList": [] } } }, "type": "object", "required": [ "cookie", "query" ], "title": "AnalyseStatsRequest", "description": "Delivery Analysis Request Model (overview / graph / detail, query passthrough)" }, "example": { "cookie": "Your_Cookie_Here", "query": { "startTime": "1780934400", "endTime": "1781625599", "page": 1, "limit": 10, "analysisType": 1, "authorSecIdList": [], "statusList": [], "SecondaryTargetIds": [], "CollectWayIds": [], "metrics": [ "stat_cost", "total_play", "total_like", "dy_comment" ], "orderByMetric": "create_time", "orderByType": 1 } } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:c6347b337504d4545940d9b1b5fdfc1d3aa12635aa599958cab5c94dfca4aedd" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/douyin/douplus/fetch_analyse_detail \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"cookie\": \"Your_Cookie_Here\",\n \"query\": {\n \"startTime\": \"1780934400\",\n \"endTime\": \"1781625599\",\n \"page\": 1,\n \"limit\": 10,\n \"analysisType\": 1,\n \"authorSecIdList\": [],\n \"statusList\": [],\n \"SecondaryTargetIds\": [],\n \"CollectWayIds\": [],\n \"metrics\": [\n \"stat_cost\",\n \"total_play\",\n \"total_like\",\n \"dy_comment\"\n ],\n \"orderByMetric\": \"create_time\",\n \"orderByType\": 1\n }\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-douplus-fetch_analyse_detail" } }, "/apis/v1/tikhub/douyin/douplus/fetch_analyse_graph": { "post": { "description": "Douyin (douplus).\n\n### Purpose\n- DOU+ delivery analysis trend graph (metric curves over time); account/video/live by query.analysisType\n- **Requires a valid www.douyin.com web Cookie**\n\n### Parameters (query passthrough)\n- Same fields as overview, plus dimension (time aggregation, e.g. 1)\n\n### Return\n- Trend graph data (metric values per time point)\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_douplus_fetch_analyse_graph", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Trend graph data (metric values per time point)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_analyse_graph", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "33a86ffb5b03" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/douplus/fetch_analyse_graph", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_douplus_fetch_analyse_graph", "method": "POST", "path": "/apis/v1/tikhub/douyin/douplus/fetch_analyse_graph" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User www.douyin.com web Cookie", "example": "Your_Cookie_Here" }, "query": { "additionalProperties": true, "type": "object", "title": "Query", "description": "Analysis query object. Key fields: startTime, endTime (second timestamp string); analysisType (1=account, 2=video, 3=live); authorSecIdList (account sec_uid list); statusList (delivery status filter); metrics (metric list, e.g. stat_cost, total_play, total_like, dy_comment, dy_share, dy_follow); SecondaryTargetIds; CollectWayIds. graph extra: dimension; detail extra: page, limit, orderByMetric, orderByType; video/live extra: liveRoomIdList", "example": { "CollectWayIds": [], "SecondaryTargetIds": [], "analysisType": 1, "authorSecIdList": [], "endTime": "1781625599", "metrics": [ "stat_cost", "total_play", "play_duration_5s_rate", "total_like", "dy_comment", "dy_share", "dy_home_visited", "dy_follow" ], "startTime": "1780934400", "statusList": [] } } }, "type": "object", "required": [ "cookie", "query" ], "title": "AnalyseStatsRequest", "description": "Delivery Analysis Request Model (overview / graph / detail, query passthrough)" }, "example": { "cookie": "Your_Cookie_Here", "query": { "startTime": "1780934400", "endTime": "1781625599", "dimension": 1, "analysisType": 1, "authorSecIdList": [], "statusList": [], "SecondaryTargetIds": [], "CollectWayIds": [], "metrics": [ "stat_cost", "total_play", "total_like", "dy_comment" ] } } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:d42d479ae0230720d8a3a7c17af559c243e0898e4c04a9727167f0f930bd7af4" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/douyin/douplus/fetch_analyse_graph \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"cookie\": \"Your_Cookie_Here\",\n \"query\": {\n \"startTime\": \"1780934400\",\n \"endTime\": \"1781625599\",\n \"dimension\": 1,\n \"analysisType\": 1,\n \"authorSecIdList\": [],\n \"statusList\": [],\n \"SecondaryTargetIds\": [],\n \"CollectWayIds\": [],\n \"metrics\": [\n \"stat_cost\",\n \"total_play\",\n \"total_like\",\n \"dy_comment\"\n ]\n }\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-douplus-fetch_analyse_graph" } }, "/apis/v1/tikhub/douyin/douplus/fetch_analyse_overview": { "post": { "description": "Douyin (douplus).\n\n### Purpose:\n- DOU+ delivery analysis overview for account / video / live (query.analysisType: 1=account, 2=video, 3=live)\n- Filter by account, delivery status, target and time range\n- **Requires a valid www.douyin.com web Cookie**\n### Parameters (query passthrough, key fields):\n- startTime / endTime: second timestamp strings (period)\n- analysisType: 1=account, 2=video, 3=live\n- authorSecIdList: list of account sec_uid (empty = all)\n- statusList: delivery status filter (empty = all)\n- metrics: requested metrics\n### Return:\n- Overview statistics\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_douplus_fetch_analyse_overview", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Overview statistics", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_analyse_overview", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "8f4f8a906c96" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/douplus/fetch_analyse_overview", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_douplus_fetch_analyse_overview", "method": "POST", "path": "/apis/v1/tikhub/douyin/douplus/fetch_analyse_overview" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User www.douyin.com web Cookie", "example": "Your_Cookie_Here" }, "query": { "additionalProperties": true, "type": "object", "title": "Query", "description": "Analysis query object. Key fields: startTime, endTime (second timestamp string); analysisType (1=account, 2=video, 3=live); authorSecIdList (account sec_uid list); statusList (delivery status filter); metrics (metric list, e.g. stat_cost, total_play, total_like, dy_comment, dy_share, dy_follow); SecondaryTargetIds; CollectWayIds. graph extra: dimension; detail extra: page, limit, orderByMetric, orderByType; video/live extra: liveRoomIdList", "example": { "CollectWayIds": [], "SecondaryTargetIds": [], "analysisType": 1, "authorSecIdList": [], "endTime": "1781625599", "metrics": [ "stat_cost", "total_play", "play_duration_5s_rate", "total_like", "dy_comment", "dy_share", "dy_home_visited", "dy_follow" ], "startTime": "1780934400", "statusList": [] } } }, "type": "object", "required": [ "cookie", "query" ], "title": "AnalyseStatsRequest", "description": "Delivery Analysis Request Model (overview / graph / detail, query passthrough)" }, "example": { "cookie": "Your_Cookie_Here", "query": { "startTime": "1780934400", "endTime": "1781625599", "analysisType": 1, "authorSecIdList": [], "statusList": [], "SecondaryTargetIds": [], "CollectWayIds": [], "metrics": [ "stat_cost", "total_play", "play_duration_5s_rate", "total_like", "dy_comment", "dy_share", "dy_home_visited", "dy_follow" ] } } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:6dd1a366206c70566f585cb1e51f84912b628d82158c74ad4a147267274e9108" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/douyin/douplus/fetch_analyse_overview \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"cookie\": \"Your_Cookie_Here\",\n \"query\": {\n \"startTime\": \"1780934400\",\n \"endTime\": \"1781625599\",\n \"analysisType\": 1,\n \"authorSecIdList\": [],\n \"statusList\": [],\n \"SecondaryTargetIds\": [],\n \"CollectWayIds\": [],\n \"metrics\": [\n \"stat_cost\",\n \"total_play\",\n \"play_duration_5s_rate\",\n \"total_like\",\n \"dy_comment\",\n \"dy_share\",\n \"dy_home_visited\",\n \"dy_follow\"\n ]\n }\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-douplus-fetch_analyse_overview" } }, "/apis/v1/tikhub/douyin/douplus/fetch_delivery_effect_estimate": { "post": { "description": "Douyin (douplus).\n\n### Purpose:\n- Get estimated delivery results for specified items, promotion target, budget and duration\n- Useful for comparing budget and duration options before creating a DOU+ order\n### Parameters:\n- item_ids: Item id(s), comma separated (required). Normally use schema=0 for one item and schema=3 for multiple items\n- external_action: Optimization action code; must match target_id. Default 44 (NativeAction); common values:\n 45=like, 46=follow, 47=comment, 51=link click, 102=multiple native actions, 181=homepage visit\n- target_id: Promotion target id, default 31 (likes and comments). Common values: 32=followers,\n 33=homepage visits, 37=video plays, 40=live popularity, 45=comment-link clicks,\n 63=show to followers, 78=natural promotion, 81=high interaction frequency\n- schema: Delivery scene code. 0=single-item Default, 3=multi-item BatchDelivery; selected from the item count\n- is_max_cv: Whether to estimate in MaxCV (maximum-conversion-volume) mode; derived from target capability,\n item count, budget and manual-bid state by the official client\n- pay_type: Payment channel. 0=CashDesk, 1=IAP, 2=Caijing, 3=CgTradeCash; the official estimate request uses 1\n- cost_int: Delivery budget in li (CNY 1/1000), default 30000 (CNY 30)\n- duration_seconds: Delivery duration in seconds, default 21600 (6 hours)\n### Return:\n- Estimated delivery results for the selected budget, duration and promotion target\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_douplus_fetch_delivery_effect_estimate", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Estimated delivery results for the selected budget, duration and promotion target", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_delivery_effect_estimate", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "douplus", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "e7306930099d" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/douplus/fetch_delivery_effect_estimate", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_douplus_fetch_delivery_effect_estimate", "method": "POST", "path": "/apis/v1/tikhub/douyin/douplus/fetch_delivery_effect_estimate" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "item_ids": { "type": "string", "minLength": 1, "title": "Item Ids", "description": "Item id(s), comma separated; normally use schema=0 for one item and schema=3 for multiple items", "example": "7677202522116819185" }, "external_action": { "type": "integer", "title": "External Action", "description": "Optimization action code; must match target_id, default 44 (NativeAction). Common values: 45=like, 46=follow, 47=comment, 51=link click, 102=multiple native actions, 181=homepage visit", "default": 44, "example": 44 }, "target_id": { "type": "integer", "title": "Target Id", "description": "Promotion target id, default 31 (likes and comments). Common values: 32=followers, 33=homepage visits, 37=video plays, 40=live popularity, 45=comment-link clicks, 63=show to followers, 78=natural promotion, 81=high interaction frequency", "default": 31, "example": 31 }, "schema": { "type": "integer", "title": "Schema", "description": "Delivery schema: 0=single-item Default, 3=multi-item BatchDelivery; the official client selects it from the item count", "default": 0, "example": 0 }, "is_max_cv": { "type": "boolean", "title": "Is Max Cv", "description": "Whether to estimate in MaxCV (maximum-conversion-volume) mode; the official client derives it from target capability, item count, budget and manual-bid state, default true", "default": true, "example": true }, "pay_type": { "type": "integer", "maximum": 3.0, "minimum": 0.0, "title": "Pay Type", "description": "Payment channel: 0=CashDesk, 1=IAP, 2=Caijing, 3=CgTradeCash; the official estimate request uses 1", "default": 1, "example": 1 }, "cost_int": { "type": "integer", "title": "Cost Int", "description": "1000), default 30000 (CNY 30", "default": 30000, "example": 30000, "exclusiveMinimum": 0 }, "duration_seconds": { "type": "integer", "title": "Duration Seconds", "description": "Delivery duration in seconds, default 21600 (6 hours", "default": 21600, "example": 21600, "exclusiveMinimum": 0 } }, "type": "object", "required": [ "item_ids" ], "title": "DeliveryEffectEstimateRequest", "description": "DOU+ Delivery Effect Estimate Request Model" }, "example": { "item_ids": "7677202522116819185", "external_action": 44, "target_id": 31, "schema": 0, "is_max_cv": true, "pay_type": 1, "cost_int": 30000, "duration_seconds": 21600 } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:4f2be55cc377c07482a4881f84c6d4149896dba2d1996c156d538d21475b75e9" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/douyin/douplus/fetch_delivery_effect_estimate \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"item_ids\": \"7677202522116819185\",\n \"external_action\": 44,\n \"target_id\": 31,\n \"schema\": 0,\n \"is_max_cv\": true,\n \"pay_type\": 1,\n \"cost_int\": 30000,\n \"duration_seconds\": 21600\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-douplus-fetch_delivery_effect_estimate" } }, "/apis/v1/tikhub/douyin/douplus/fetch_promotable_item_list": { "post": { "description": "Douyin (douplus).\n\n### Purpose:\n- Get the promotable item (video) list for a given Douyin account on the DOU+ delivery page,\n including like / comment / play counts per item\n### Parameters:\n- sec_uid: sec_uid of the delivery account (required)\n- count: Number of items, default 30\n- target_id: Promotion target (the goal card on the DOU+ page), default 31 (likes & comments).\n 31=likes&comments, 32=fans, 33=homepage views, 37=video plays, 40=live popularity,\n 45=comment-link clicks, 63=show-to-fans, 78=high-quality interaction. **Keep 31 for a plain video list**\n- aim_ids: Optional advanced parameter — optimization objective code(s), comma separated.\n **Leave empty** — auto-derived from target_id when omitted; set manually only for advanced cases\n### Return:\n- Promotable item list (item id, title, cover, like / comment / play counts, etc.)\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_douplus_fetch_promotable_item_list", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Promotable item list (item id, title, cover, like / comment / play counts, etc.)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_promotable_item_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "93ef984792c8" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/douplus/fetch_promotable_item_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_douplus_fetch_promotable_item_list", "method": "POST", "path": "/apis/v1/tikhub/douyin/douplus/fetch_promotable_item_list" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "sec_uid": { "type": "string", "title": "Sec Uid", "description": "Delivery account sec_uid", "example": "MS4wLjABAAAA9fe7vGjwyiaOjL6REhX8rvmSb32VzA_XsKca9F3_YSHRXlEqgT2cpX54WGbtgnsA" }, "count": { "title": "Count", "description": "Number of items, default 30", "default": 30, "example": 30, "type": [ "integer", "null" ] }, "target_id": { "title": "Target Id", "description": "Promotion target ID (the goal card on the DOU+ page). 31=Likes & Comments, 32=Followers, 33=Profile visits, 37=Video views, 40=Live room popularity, 45=Comment link clicks, 63=Shown to followers, 78=High-quality engagement. Only filters promotable items by goal; keep 31 for a plain video list", "default": 31, "example": 31, "type": [ "integer", "null" ] }, "aim_ids": { "title": "Aim Ids", "description": "Optional advanced param: optimization objective code(s), comma separated; leave empty (auto-matched by target_id), usually no need to set", "type": [ "string", "null" ] } }, "type": "object", "required": [ "sec_uid" ], "title": "PromotableItemListRequest", "description": "Promotable Item List Request Model" }, "example": { "sec_uid": "MS4wLjABAAAA9fe7vGjwyiaOjL6REhX8rvmSb32VzA_XsKca9F3_YSHRXlEqgT2cpX54WGbtgnsA", "count": 30, "target_id": 31 } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:47fd3435b011b06b65a4bf593b9a0dd1ff1c838ef940a0c6a151cb329ebbfabe" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/douyin/douplus/fetch_promotable_item_list \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"sec_uid\": \"MS4wLjABAAAA9fe7vGjwyiaOjL6REhX8rvmSb32VzA_XsKca9F3_YSHRXlEqgT2cpX54WGbtgnsA\",\n \"count\": 30,\n \"target_id\": 31\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-douplus-fetch_promotable_item_list" } }, "/apis/v1/tikhub/douyin/douplus/fetch_promoted_accounts": { "post": { "description": "Douyin (douplus).\n\n### Purpose:\n- Get the list of Douyin accounts that have been promoted (have orders) under the current DOU+ account, with cursor pagination\n- **Requires a valid www.douyin.com web Cookie**\n### Parameters:\n- cookie: User's www.douyin.com web Cookie (required)\n- limit: Number of accounts per page, default 20\n- cursor: Pagination cursor, empty for first page, then pass the `sortID` value from the previous response\n### Return:\n- List of promoted accounts (nickname, sec_uid, etc.)\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_douplus_fetch_promoted_accounts", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- List of promoted accounts (nickname, sec_uid, etc.)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_promoted_accounts", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "9e84a34526e6" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/douplus/fetch_promoted_accounts", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_douplus_fetch_promoted_accounts", "method": "POST", "path": "/apis/v1/tikhub/douyin/douplus/fetch_promoted_accounts" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User www.douyin.com web Cookie", "example": "Your_Cookie_Here" }, "limit": { "title": "Limit", "description": "Number of accounts per page, default 20", "default": 20, "example": 20, "type": [ "integer", "null" ] }, "cursor": { "title": "Cursor", "description": "Pagination cursor, empty for first page, then pass the `sortID` value from the previous response", "default": "", "example": "", "type": [ "string", "null" ] } }, "type": "object", "required": [ "cookie" ], "title": "PromotedAccountsRequest", "description": "Promoted Accounts Request Model" }, "example": { "cookie": "Your_Cookie_Here", "limit": 20, "cursor": "" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:b1db79643f644c2e9bc897e60c8af038eb2db5b6ed377bf408bc41f9068a6fdf" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/douyin/douplus/fetch_promoted_accounts \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"cookie\": \"Your_Cookie_Here\",\n \"limit\": 20,\n \"cursor\": \"\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-douplus-fetch_promoted_accounts" } }, "/apis/v1/tikhub/douyin/douplus/fetch_sec_token": { "post": { "description": "Douyin (douplus).\n\n### Purpose:\n- Get the sec_token required by DOU+ authenticated POST endpoints (e.g. cost estimation)\n- **Requires a valid www.douyin.com web Cookie**\n### Parameters:\n- cookie: User's www.douyin.com web Cookie (required)\n### Return:\n- Data containing the sec_token, used for subsequent DOU+ authenticated POST endpoints\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_douplus_fetch_sec_token", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Data containing the sec_token, used for subsequent DOU+ authenticated POST endpoints", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_sec_token", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "706034554f0d" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/douplus/fetch_sec_token", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_douplus_fetch_sec_token", "method": "POST", "path": "/apis/v1/tikhub/douyin/douplus/fetch_sec_token" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User www.douyin.com web Cookie", "example": "Your_Cookie_Here" } }, "type": "object", "required": [ "cookie" ], "title": "SecTokenRequest", "description": "Sec Token Request Model (cookie only)" }, "example": { "cookie": "Your_Cookie_Here" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:90f5b52087ff01206bc2f5dfaa2f872944ee89b40b30707d795519d19fa79e4f" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/douyin/douplus/fetch_sec_token \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"cookie\": \"Your_Cookie_Here\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-douplus-fetch_sec_token" } }, "/apis/v1/tikhub/douyin/douplus/fetch_talent_categories": { "post": { "description": "Douyin (douplus).\n\n### Purpose:\n- Get the DOU+ talent category list; a category name can be used as the `name` of the talent search endpoint\n### Return:\n- Talent category list\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_douplus_fetch_talent_categories", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Talent category list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_talent_categories", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "8c8ec32e6d69" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/douplus/fetch_talent_categories", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_douplus_fetch_talent_categories", "method": "POST", "path": "/apis/v1/tikhub/douyin/douplus/fetch_talent_categories" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "cookie": { "title": "Cookie", "description": "User www.douyin.com web Cookie", "type": [ "string", "null" ] } }, "type": "object", "title": "TalentCategoryRequest", "description": "Talent Category List Request Model" }, "example": {} } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:c3b204fff271689f6656f96affceae6f3be996d888b8604e8a92a00cc200504e" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/douyin/douplus/fetch_talent_categories \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-douplus-fetch_talent_categories" } }, "/apis/v1/tikhub/douyin/douplus/fetch_talents_by_category": { "post": { "description": "Douyin (douplus).\n\n### Purpose\n- Search & filter DOU+ talents by category\n\n### Parameters\n- name: Category name or keyword (from the talent category endpoint); empty for all\n- page: Page index from 0, default 0\n- limit: Page size, default 20\n\n### Return\n- Talent list\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_douplus_fetch_talents_by_category", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Talent list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_talents_by_category", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "24febb44388e" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/douplus/fetch_talents_by_category", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_douplus_fetch_talents_by_category", "method": "POST", "path": "/apis/v1/tikhub/douyin/douplus/fetch_talents_by_category" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "cookie": { "title": "Cookie", "description": "User www.douyin.com web Cookie", "type": [ "string", "null" ] }, "name": { "title": "Name", "description": "Category name or keyword (from the talent category endpoint); empty for all", "default": "", "example": "音乐", "type": [ "string", "null" ] }, "page": { "title": "Page", "description": "Page index from 0", "default": 0, "example": 0, "type": [ "integer", "null" ] }, "limit": { "title": "Limit", "description": "Page size, default 20", "default": 20, "example": 20, "type": [ "integer", "null" ] } }, "type": "object", "title": "TalentByCategoryRequest", "description": "Search Talents By Category Request Model" }, "example": { "name": "音乐", "page": 0, "limit": 20 } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:2bf1a2ae3d14477955382629e5e12913f561472bb8b04ec9184582fa635f2188" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/douyin/douplus/fetch_talents_by_category \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"name\": \"音乐\",\n \"page\": 0,\n \"limit\": 20\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-douplus-fetch_talents_by_category" } }, "/apis/v1/tikhub/douyin/douplus/fetch_user_posts": { "post": { "description": "Douyin (douplus).\n\n### Purpose:\n- Get a user's homepage works (concise endpoint, cursor pagination)\n### Parameters:\n- sec_uid: User sec_uid (required)\n- cursor: Pagination cursor (string), \"0\" for first page, then pass the cursor from the previous response\n- count: Page size, default 10\n### Return:\n- User's works list plus pagination info\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_douplus_fetch_user_posts", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- User's works list plus pagination info", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_user_posts", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "849a500b15eb" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/douplus/fetch_user_posts", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_douplus_fetch_user_posts", "method": "POST", "path": "/apis/v1/tikhub/douyin/douplus/fetch_user_posts" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "cookie": { "title": "Cookie", "description": "User www.douyin.com web Cookie", "type": [ "string", "null" ] }, "sec_uid": { "type": "string", "title": "Sec Uid", "description": "User sec_uid", "example": "MS4wLjABAAAA9fe7vGjwyiaOjL6REhX8rvmSb32VzA_XsKca9F3_YSHRXlEqgT2cpX54WGbtgnsA" }, "cursor": { "title": "Cursor", "description": "Pagination cursor (string), \"0\" for first page, then pass the cursor from the previous response", "default": "0", "example": "0", "type": [ "string", "null" ] }, "count": { "title": "Count", "description": "Page size, default 10", "default": 10, "example": 10, "type": [ "integer", "null" ] } }, "type": "object", "required": [ "sec_uid" ], "title": "UserPostsRequest", "description": "User Homepage Posts Request Model" }, "example": { "sec_uid": "MS4wLjABAAAA9fe7vGjwyiaOjL6REhX8rvmSb32VzA_XsKca9F3_YSHRXlEqgT2cpX54WGbtgnsA", "cursor": "0", "count": 10 } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:65a990041845993cb53a4d4f0fdb8aa596f374ca6c9e149a5dad856e2874764b" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/douyin/douplus/fetch_user_posts \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"sec_uid\": \"MS4wLjABAAAA9fe7vGjwyiaOjL6REhX8rvmSb32VzA_XsKca9F3_YSHRXlEqgT2cpX54WGbtgnsA\",\n \"cursor\": \"0\",\n \"count\": 10\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-douplus-fetch_user_posts" } }, "/apis/v1/tikhub/douyin/douplus/fetch_video_detail": { "post": { "description": "Douyin (douplus).\n\n### Purpose:\n- Get a video's detail by its ID or share link/text\n### Parameters:\n- video: Video ID, or share link/text (required). e.g. `7651708301280906538`, or a share caption containing a v.douyin.com link\n### Return:\n- Matched video data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_douplus_fetch_video_detail", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Matched video data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_video_detail", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "248fb30dc5c8" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/douplus/fetch_video_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_douplus_fetch_video_detail", "method": "POST", "path": "/apis/v1/tikhub/douyin/douplus/fetch_video_detail" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "cookie": { "title": "Cookie", "description": "User www.douyin.com web Cookie", "type": [ "string", "null" ] }, "video": { "type": "string", "title": "Video", "description": "Video ID, or share link/text. e.g. \"7651708301280906538\" or a share message containing a v.douyin.com link", "example": "7651708301280906538" } }, "type": "object", "required": [ "video" ], "title": "VideoDetailRequest", "description": "Video Detail Request Model (by video ID or link)" }, "example": { "video": "7651708301280906538" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:ff7b86439742d787f5696050129e30ddf6279be5d685689d72fec6897d60fdf4" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/douyin/douplus/fetch_video_detail \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"video\": \"7651708301280906538\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-douplus-fetch_video_detail" } }, "/apis/v1/tikhub/douyin/douplus/fetch_video_ranking": { "post": { "description": "Douyin (douplus).\n\n### Purpose:\n- Get the DOU+ video ranking board, filterable by time range, category and dimension\n### Parameters:\n- time_range: Time range, 1 / 2 / 3, default 2\n- tag_id: Category id, default 634 (Entertainment). Full map: 601 Plot, 602 Star, 606 Music, 607 ACGN,\n 608 Game, 609 CurrentAffairs, 612 Dance, 614 Agriculture, 615 Sci-Tech, 616 Finance, 617 ParentChild,\n 619 Life, 621 Health, 623 Emotion, 624 Culture, 625 Office, 626 Education, 627 Photography, 628 Food,\n 629 Travel, 631 Fashion, 633 Sport, 634 Entertainment, 635 Car\n- dim_type: Ranking dimension, default 5. 1=low-fan hits, 2=high completion, 3=high like-rate, 4=high follower-growth, 5=hotness index\n- adv_id: Advertiser id, optional\n### Return:\n- Video ranking data (items, authors, metrics, etc.)\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_douplus_fetch_video_ranking", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Video ranking data (items, authors, metrics, etc.)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_video_ranking", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "495bf602d6f5" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/douplus/fetch_video_ranking", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_douplus_fetch_video_ranking", "method": "POST", "path": "/apis/v1/tikhub/douyin/douplus/fetch_video_ranking" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "time_range": { "title": "Time Range", "description": "Time range: 1 / 2 / 3", "default": 2, "example": 2, "type": [ "integer", "null" ] }, "tag_id": { "title": "Tag Id", "description": "Category id. 601 Drama, 602 Celebrity, 606 Music, 607 Anime, 608 Gaming, 609 Current Affairs, 612 Dance, 614 Agriculture, 615 Technology, 616 Finance, 617 Parenting, 619 Lifestyle, 621 Health, 623 Emotions, 624 Culture, 625 Workplace, 626 Education, 627 Photography, 628 Food, 629 Travel, 631 Fashion, 633 Sports, 634 Entertainment, 635 Automotive", "default": 634, "example": 634, "type": [ "integer", "null" ] }, "dim_type": { "title": "Dim Type", "description": "Ranking dimension: 1=Low-follower Viral, 2=High Completion Rate, 3=High Like Rate, 4=High Follower Growth Rate, 5=Popularity Index", "default": 5, "example": 5, "type": [ "integer", "null" ] }, "adv_id": { "title": "Adv Id", "description": "Advertiser id (optional)", "default": "", "example": "", "type": [ "string", "null" ] } }, "type": "object", "title": "VideoRankingRequest", "description": "DOU+ Video Ranking Request Model" }, "example": { "time_range": 2, "tag_id": 634, "dim_type": 5, "adv_id": "" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:3bb7e427c7629bb212c16c69be0e0a6dc81d4f47f9aecf197b712fc8750dc791" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/douyin/douplus/fetch_video_ranking \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"time_range\": 2,\n \"tag_id\": 634,\n \"dim_type\": 5,\n \"adv_id\": \"\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-douplus-fetch_video_ranking" } }, "/apis/v1/tikhub/douyin/douplus/search_live_room": { "post": { "description": "Douyin (douplus).\n\n### Purpose:\n- Search DOU+ live rooms by Douyin ID or nickname, with cursor pagination\n### Parameters:\n- keyword: Douyin ID or nickname (required)\n- cursor: Pagination cursor, 0 for first page, then pass the cursor from the previous response\n- count: Page size, default 10\n### Return:\n- Matched live room list plus pagination info\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_douplus_search_live_room", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Matched live room list plus pagination info", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin search_live_room", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "6c8fec0865a9" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/douplus/search_live_room", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_douplus_search_live_room", "method": "POST", "path": "/apis/v1/tikhub/douyin/douplus/search_live_room" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "cookie": { "title": "Cookie", "description": "User www.douyin.com web Cookie", "type": [ "string", "null" ] }, "keyword": { "type": "string", "title": "Keyword", "description": "Douyin ID or nickname", "example": "Xiao Erduo" }, "cursor": { "title": "Cursor", "description": "Pagination cursor, 0 for first page, then pass the cursor from the previous response", "default": 0, "example": 0, "type": [ "integer", "null" ] }, "count": { "title": "Count", "description": "Page size, default 10", "default": 10, "example": 10, "type": [ "integer", "null" ] } }, "type": "object", "required": [ "keyword" ], "title": "LiveRoomSearchRequest", "description": "Live Room Search Request Model (by Douyin ID or nickname)" }, "example": { "keyword": "Xiao Erduo", "cursor": 0, "count": 10 } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:5571f7165342e31306540690949c9fe167c9ec651cbbef0e0a0ca40aa65ace12" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/douyin/douplus/search_live_room \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"keyword\": \"Xiao Erduo\",\n \"cursor\": 0,\n \"count\": 10\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-douplus-search_live_room" } }, "/apis/v1/tikhub/douyin/douplus/search_user_v2": { "post": { "description": "Douyin (douplus).\n\n### Purpose:\n- DOU+ user search V2, with cursor pagination and a search scope\n### Parameters:\n- keyword: Search keyword (required)\n- cursor: Pagination cursor, 0 for first page, then pass the cursor from the previous response\n- count: Page size, default 10\n- scope: Search scope, default 1\n### Return:\n- Matched result list plus pagination info\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_douplus_search_user_v2", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Matched result list plus pagination info", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin search_user", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "fa376ea06fe0" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/douplus/search_user_v2", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_douplus_search_user_v2", "method": "POST", "path": "/apis/v1/tikhub/douyin/douplus/search_user_v2" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "cookie": { "title": "Cookie", "description": "User www.douyin.com web Cookie", "type": [ "string", "null" ] }, "keyword": { "type": "string", "title": "Keyword", "description": "Search keyword", "example": "Bo" }, "cursor": { "title": "Cursor", "description": "Pagination cursor, 0 for first page, then pass the cursor from the previous response", "default": 0, "example": 0, "type": [ "integer", "null" ] }, "count": { "title": "Count", "description": "Page size, default 10", "default": 10, "example": 10, "type": [ "integer", "null" ] }, "scope": { "title": "Scope", "description": "Search scope, default 1", "default": 1, "example": 1, "type": [ "integer", "null" ] } }, "type": "object", "required": [ "keyword" ], "title": "UserSearchV2Request", "description": "DOU+ User Search V2 Request Model" }, "example": { "keyword": "Bo", "cursor": 0, "count": 10, "scope": 1 } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:90b65c48802aa1102e2a5d4a7959d0ff8c5524f9e9345d87d3b07b3789d06af3" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/douyin/douplus/search_user_v2 \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"keyword\": \"Bo\",\n \"cursor\": 0,\n \"count\": 10,\n \"scope\": 1\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-douplus-search_user_v2" } }, "/apis/v1/tikhub/douyin/douplus/search_video": { "post": { "description": "Douyin (douplus).\n\n### Purpose:\n- Search DOU+ videos by title/keyword, with cursor pagination\n### Parameters:\n- keyword: Video title or keyword (required)\n- cursor: Pagination cursor, 0 for first page, then pass the cursor from the previous response\n- count: Page size, default 12\n### Return:\n- Matched video list plus pagination info\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_douplus_search_video", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Matched video list plus pagination info", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin search_video", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "191e0f7628cf" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/douplus/search_video", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_douplus_search_video", "method": "POST", "path": "/apis/v1/tikhub/douyin/douplus/search_video" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "cookie": { "title": "Cookie", "description": "User www.douyin.com web Cookie", "type": [ "string", "null" ] }, "keyword": { "type": "string", "title": "Keyword", "description": "Video title or keyword", "example": "major" }, "cursor": { "title": "Cursor", "description": "Pagination cursor, 0 for first page, then pass the cursor from the previous response", "default": 0, "example": 0, "type": [ "integer", "null" ] }, "count": { "title": "Count", "description": "Page size, default 12", "default": 12, "example": 12, "type": [ "integer", "null" ] } }, "type": "object", "required": [ "keyword" ], "title": "VideoSearchRequest", "description": "Video Search Request Model (by title/keyword)" }, "example": { "keyword": "major", "cursor": 0, "count": 12 } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:0829e9cd3dc7022e588dd9561a3593de0279bf4e743cf369f85612a55558c1a4" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/douyin/douplus/search_video \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"keyword\": \"major\",\n \"cursor\": 0,\n \"count\": 12\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-douplus-search_video" } }, "/apis/v1/tikhub/douyin/index/fetch_all_area": { "get": { "description": "Douyin (index).\n\n### Purpose:\n- Get all supported area list for Douyin Index\n### Return:\n- Hierarchical list of provinces and cities, used as region filter parameter in keyword index APIs\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_index_fetch_all_area", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Hierarchical list of provinces and cities, used as region filter parameter in keyword index APIs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_all_area", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "5b7e051d875d" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/index/fetch_all_area", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_index_fetch_all_area", "method": "GET", "path": "/apis/v1/tikhub/douyin/index/fetch_all_area" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:39e18287cce7ff0ffcde43e26d31df7af7dfaed89bdc81ed21009b48dc4dbba7" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-index-fetch_all_area" } }, "/apis/v1/tikhub/douyin/index/fetch_all_valid_date": { "get": { "description": "Douyin (index).\n\n### Purpose:\n- Get the latest valid dates for each data type in Douyin Index\n### Return:\n- Contains latest available daily/weekly/monthly dates for keyword, brand, topic dimensions\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_index_fetch_all_valid_date", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Contains latest available daily/weekly/monthly dates for keyword, brand, topic dimensions", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_all_valid_date", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "d5773c5ccc8a" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/index/fetch_all_valid_date", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_index_fetch_all_valid_date", "method": "GET", "path": "/apis/v1/tikhub/douyin/index/fetch_all_valid_date" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:93919edefb1cc275f236ea888c7c53ca8af54a535080ad2331539b4dac5e1a38" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-index-fetch_all_valid_date" } }, "/apis/v1/tikhub/douyin/index/fetch_brand_cycles": { "post": { "description": "Douyin (index).\n\n### Purpose:\n- Get brand cycles data (periodic popularity analysis)\n### Parameters:\n- brand_name: Brand info\n- start_date/end_date: Date range in YYYYMMDD\n- app_name: Platform\n### Return:\n- Brand periodic popularity data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_index_fetch_brand_cycles", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Brand periodic popularity data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_brand_cycles", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "74cb1a6414f7" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/index/fetch_brand_cycles", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_index_fetch_brand_cycles", "method": "POST", "path": "/apis/v1/tikhub/douyin/index/fetch_brand_cycles" }, "parameters": [ { "name": "app_name", "in": "query", "required": false, "schema": { "enum": [ "aweme", "toutiao" ], "type": "string", "description": "Platform: aweme (Douyin), toutiao (Toutiao)", "default": "aweme", "title": "App Name" }, "description": "Platform: aweme (Douyin), toutiao (Toutiao)" }, { "name": "brand_name", "in": "query", "required": true, "schema": { "type": "string", "description": "Brand name", "title": "Brand Name" }, "description": "Brand name" }, { "name": "end_date", "in": "query", "required": true, "schema": { "type": "string", "description": "End date YYYYMMDD", "title": "End Date" }, "description": "End date YYYYMMDD" }, { "name": "start_date", "in": "query", "required": true, "schema": { "type": "string", "description": "Start date YYYYMMDD", "title": "Start Date" }, "description": "Start date YYYYMMDD" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:a0a522866c30c2b1cfd0e90b3ba49fd09d237704cf1b233d55a440472dce01ce" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-index-fetch_brand_cycles" } }, "/apis/v1/tikhub/douyin/index/fetch_brand_hot_videos_time_scope": { "post": { "description": "Douyin (index).\n\n### Purpose:\n- Get the queryable time scope for the brand hot videos feature\n- Used to determine valid date boundaries before calling other brand endpoints\n### Parameters:\n- None\n### Return:\n- Time scope info (start/end dates, period units, etc.)\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_index_fetch_brand_hot_videos_time_scope", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Time scope info (start/end dates, period units, etc.)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_brand_hot_videos_time_scope", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "9811b57d22c5" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/index/fetch_brand_hot_videos_time_scope", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_index_fetch_brand_hot_videos_time_scope", "method": "POST", "path": "/apis/v1/tikhub/douyin/index/fetch_brand_hot_videos_time_scope" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:8fedf071fcb6cfc8f7d720c9d71a5548f0656e6afc9660d5f5c4b6b832c9a40c" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-index-fetch_brand_hot_videos_time_scope" } }, "/apis/v1/tikhub/douyin/index/fetch_brand_initiative_rank_weekly": { "post": { "description": "Douyin (index).\n\n### Purpose\n- Get brand initiative rank weekly data\n\n### Parameters\n- brand_name/: Brand info\n- start_date/end_date: Date range in YYYYMMDD\n- app_name: Platform\n\n### Return\n- Brand initiative ranking data for the week\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_index_fetch_brand_initiative_rank_weekly", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Brand initiative ranking data for the week", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_brand_initiative_rank_weekly", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "9a85794a071a" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/index/fetch_brand_initiative_rank_weekly", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_index_fetch_brand_initiative_rank_weekly", "method": "POST", "path": "/apis/v1/tikhub/douyin/index/fetch_brand_initiative_rank_weekly" }, "parameters": [ { "name": "app_name", "in": "query", "required": false, "schema": { "enum": [ "aweme", "toutiao" ], "type": "string", "description": "Platform: aweme (Douyin), toutiao (Toutiao)", "default": "aweme", "title": "App Name" }, "description": "Platform: aweme (Douyin), toutiao (Toutiao)" }, { "name": "brand_name", "in": "query", "required": true, "schema": { "type": "string", "description": "Brand name", "title": "Brand Name" }, "description": "Brand name" }, { "name": "end_date", "in": "query", "required": true, "schema": { "type": "string", "description": "End date YYYYMMDD", "title": "End Date" }, "description": "End date YYYYMMDD" }, { "name": "start_date", "in": "query", "required": true, "schema": { "type": "string", "description": "Start date YYYYMMDD", "title": "Start Date" }, "description": "Start date YYYYMMDD" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:a1f8e01b2739507b13cebdba4ac7f2209567750aac08a92a3df2d983d3c2eb26" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-index-fetch_brand_initiative_rank_weekly" } }, "/apis/v1/tikhub/douyin/index/fetch_brand_lines": { "post": { "description": "Douyin (index).\n\n### Purpose:\n- Get brand trend lines data (popularity over time)\n### Parameters:\n- brand_name: Brand info\n- start_date/end_date: Date range in YYYYMMDD\n- app_name: Platform\n### Return:\n- Brand popularity trend line data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_index_fetch_brand_lines", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Brand popularity trend line data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_brand_lines", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "8d657dfe2215" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/index/fetch_brand_lines", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_index_fetch_brand_lines", "method": "POST", "path": "/apis/v1/tikhub/douyin/index/fetch_brand_lines" }, "parameters": [ { "name": "app_name", "in": "query", "required": false, "schema": { "enum": [ "aweme", "toutiao" ], "type": "string", "description": "Platform: aweme (Douyin), toutiao (Toutiao)", "default": "aweme", "title": "App Name" }, "description": "Platform: aweme (Douyin), toutiao (Toutiao)" }, { "name": "brand_name", "in": "query", "required": true, "schema": { "type": "string", "description": "Brand name", "title": "Brand Name" }, "description": "Brand name" }, { "name": "end_date", "in": "query", "required": true, "schema": { "type": "string", "description": "End date YYYYMMDD", "title": "End Date" }, "description": "End date YYYYMMDD" }, { "name": "start_date", "in": "query", "required": true, "schema": { "type": "string", "description": "Start date YYYYMMDD", "title": "Start Date" }, "description": "Start date YYYYMMDD" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:81351a52b7359dc8eb2f1333e39e1c118504c10414787229ec536d707096e853" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-index-fetch_brand_lines" } }, "/apis/v1/tikhub/douyin/index/fetch_brand_radar_chart": { "post": { "description": "Douyin (index).\n\n### Purpose:\n- Get brand radar chart data (multi-dimensional scores)\n### Parameters:\n- brand_name: Brand name\n- start_date/end_date: Date range in YYYYMMDD\n- app_name: Platform selection\n### Return:\n- Brand multi-dimensional radar chart data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_index_fetch_brand_radar_chart", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Brand multi-dimensional radar chart data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_brand_radar_chart", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "180840df985b" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/index/fetch_brand_radar_chart", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_index_fetch_brand_radar_chart", "method": "POST", "path": "/apis/v1/tikhub/douyin/index/fetch_brand_radar_chart" }, "parameters": [ { "name": "app_name", "in": "query", "required": false, "schema": { "enum": [ "aweme", "toutiao" ], "type": "string", "description": "Platform: aweme (Douyin), toutiao (Toutiao)", "default": "aweme", "title": "App Name" }, "description": "Platform: aweme (Douyin), toutiao (Toutiao)" }, { "name": "brand_name", "in": "query", "required": true, "schema": { "type": "string", "description": "Brand name", "title": "Brand Name" }, "description": "Brand name" }, { "name": "end_date", "in": "query", "required": true, "schema": { "type": "string", "description": "End date YYYYMMDD", "title": "End Date" }, "description": "End date YYYYMMDD" }, { "name": "start_date", "in": "query", "required": true, "schema": { "type": "string", "description": "Start date YYYYMMDD", "title": "Start Date" }, "description": "Start date YYYYMMDD" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:0cc3be5de50e39e356e9cd5fa6faddcfab674301774775e95b2e55cbc6de49a6" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-index-fetch_brand_radar_chart" } }, "/apis/v1/tikhub/douyin/index/fetch_brand_suggest": { "post": { "description": "Douyin (index).\n\n### Purpose:\n- Get brand search auto-complete suggestion list\n### Parameters:\n- keyword: Brand name keyword\n### Return:\n- Matched brand list (brand name, category ID, etc.)\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_index_fetch_brand_suggest", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Matched brand list (brand name, category ID, etc.)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_brand_suggest", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "c9b86a7f0c64" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/index/fetch_brand_suggest", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_index_fetch_brand_suggest", "method": "POST", "path": "/apis/v1/tikhub/douyin/index/fetch_brand_suggest" }, "parameters": [ { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Brand keyword", "title": "Keyword" }, "description": "Brand keyword" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:761ebd895b494a960a0b9ceb9bb07d8941b7a4e5e9234bbd927c91277023889c" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-index-fetch_brand_suggest" } }, "/apis/v1/tikhub/douyin/index/fetch_brand_valid_info": { "post": { "description": "Douyin (index).\n\n### Purpose:\n- Get brand valid info and brand index data\n### Parameters:\n- keyword_list: Brand name list, comma separated\n### Return:\n- Brand index, available date range, etc.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_index_fetch_brand_valid_info", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Brand index, available date range, etc.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_brand_valid_info", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "aef735330a0f" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/index/fetch_brand_valid_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_index_fetch_brand_valid_info", "method": "POST", "path": "/apis/v1/tikhub/douyin/index/fetch_brand_valid_info" }, "parameters": [ { "name": "keyword_list", "in": "query", "required": true, "schema": { "type": "string", "description": "Brand list, comma separated", "title": "Keyword List" }, "description": "Brand list, comma separated" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:fe44fece3ecb4b1e97f692bab7cc58c84fda8b75bff4c8f05f48ad08925363c6" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-index-fetch_brand_valid_info" } }, "/apis/v1/tikhub/douyin/index/fetch_content_author_portrait": { "post": { "description": "Douyin (index).\n\n### Purpose:\n- Get **creator (author) portrait** for a category (i.e. profile of users who post in this category)\n- Used to understand creator demographics: gender, age, region, active time\n### Parameters:\n- tag_id: Required category ID as a string, excluding \"0\" (all categories). Obtain an entry's `id` from the `categories` list returned by `GET /tikhub/douyin/index/fetch_item_filter_options` (operationId: `get_tikhub_douyin_index_fetch_item_filter_options`).\n- period: \"week\" (end_date must be a Sunday) or \"month\" (end_date must be month-end, e.g. 20260331)\n- end_date: End date YYYYMMDD, must align with period\n### Return:\n- Creator portrait: gender, age group, region, device, active time distributions\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_index_fetch_content_author_portrait", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Creator portrait: gender, age group, region, device, active time distributions", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_content_author_portrait", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "0f18f60deac7" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/index/fetch_content_author_portrait", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_index_fetch_content_author_portrait", "method": "POST", "path": "/apis/v1/tikhub/douyin/index/fetch_content_author_portrait" }, "parameters": [ { "name": "end_date", "in": "query", "required": true, "schema": { "type": "string", "description": "End date in YYYYMMDD format. When `period=\"week\"`, this date must be a Sunday; when `period=\"month\"`, it must be the last day of the month.", "title": "End Date" }, "description": "End date in YYYYMMDD format. When `period=\"week\"`, this date must be a Sunday; when `period=\"month\"`, it must be the last day of the month." }, { "name": "period", "in": "query", "required": false, "schema": { "enum": [ "week", "month" ], "type": "string", "description": "Period: week or month\n\nUsage: \"week\" (end_date must be a Sunday) or \"month\" (end_date must be month-end, e.g. 20260331)", "default": "month", "title": "Period" }, "description": "Period: week or month\n\nUsage: \"week\" (end_date must be a Sunday) or \"month\" (end_date must be month-end, e.g. 20260331)" }, { "name": "tag_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Required category ID as a string. Call `GET /tikhub/douyin/index/fetch_item_filter_options` (operationId: `get_tikhub_douyin_index_fetch_item_filter_options`) and use an entry's `id` from the `categories` list in the response payload. Convert the ID to a string for `tag_id`. This endpoint does not accept `\"0\"` (all categories); select a specific category and exclude the entry with `id=0`.", "title": "Tag Id" }, "description": "Required category ID as a string. Call `GET /tikhub/douyin/index/fetch_item_filter_options` (operationId: `get_tikhub_douyin_index_fetch_item_filter_options`) and use an entry's `id` from the `categories` list in the response payload. Convert the ID to a string for `tag_id`. This endpoint does not accept `\"0\"` (all categories); select a specific category and exclude the entry with `id=0`." } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:97e93490e972a12518bff0fc15406e2dad74af4e7ad6c572ff5349a8f8c7f2d9" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-index-fetch_content_author_portrait" } }, "/apis/v1/tikhub/douyin/index/fetch_content_consume_trend": { "post": { "description": "Douyin (index).\n\n### Purpose:\n- Get consumption (play count, watch duration) trend over time for a category\n- Measures actual viewing heat for content in this category\n### Parameters:\n- tag_id: Required category ID as a string, excluding \"0\" (all categories). Obtain an entry's `id` from the `categories` list returned by `GET /tikhub/douyin/index/fetch_item_filter_options` (operationId: `get_tikhub_douyin_index_fetch_item_filter_options`).\n- start_date: Start date YYYYMMDD (inclusive)\n- end_date: End date YYYYMMDD (inclusive)\n### Return:\n- Daily aggregated consumption data: total play count, watch duration, unique viewers per day\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_index_fetch_content_consume_trend", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Daily aggregated consumption data: total play count, watch duration, unique viewers per day", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_content_consume_trend", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "67280897a28e" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/index/fetch_content_consume_trend", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_index_fetch_content_consume_trend", "method": "POST", "path": "/apis/v1/tikhub/douyin/index/fetch_content_consume_trend" }, "parameters": [ { "name": "end_date", "in": "query", "required": true, "schema": { "type": "string", "description": "End date YYYYMMDD", "title": "End Date" }, "description": "End date YYYYMMDD" }, { "name": "start_date", "in": "query", "required": true, "schema": { "type": "string", "description": "Start date YYYYMMDD", "title": "Start Date" }, "description": "Start date YYYYMMDD" }, { "name": "tag_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Required category ID as a string. Call `GET /tikhub/douyin/index/fetch_item_filter_options` (operationId: `get_tikhub_douyin_index_fetch_item_filter_options`) and use an entry's `id` from the `categories` list in the response payload. Convert the ID to a string for `tag_id`. This endpoint does not accept `\"0\"` (all categories); select a specific category and exclude the entry with `id=0`.", "title": "Tag Id" }, "description": "Required category ID as a string. Call `GET /tikhub/douyin/index/fetch_item_filter_options` (operationId: `get_tikhub_douyin_index_fetch_item_filter_options`) and use an entry's `id` from the `categories` list in the response payload. Convert the ID to a string for `tag_id`. This endpoint does not accept `\"0\"` (all categories); select a specific category and exclude the entry with `id=0`." } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:155b2a36635f9b66eba34f746ea4a3fc07e7908d97e9c24eb8af09cc3d7f3ae8" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-index-fetch_content_consume_trend" } }, "/apis/v1/tikhub/douyin/index/fetch_content_consumer_portrait": { "post": { "description": "Douyin (index).\n\n### Purpose:\n- Get **consumer (viewer) portrait** for a category (i.e. profile of users who watch videos in this category)\n- Counterpart to fetch_content_author_portrait: one for creators, one for viewers\n### Parameters:\n- tag_id: Required category ID as a string, excluding \"0\" (all categories). Obtain an entry's `id` from the `categories` list returned by `GET /tikhub/douyin/index/fetch_item_filter_options` (operationId: `get_tikhub_douyin_index_fetch_item_filter_options`).\n- period: \"week\" (end_date must be a Sunday) or \"month\" (end_date must be month-end, e.g. 20260331)\n- end_date: End date YYYYMMDD, must align with period\n### Return:\n- Consumer portrait: gender, age group, region, interest, device distributions\n\nAPI references: `fetch_content_author_portrait` = `POST /tikhub/douyin/index/fetch_content_author_portrait` (operationId: `post_tikhub_douyin_index_fetch_content_author_portrait`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_index_fetch_content_consumer_portrait", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Consumer portrait: gender, age group, region, interest, device distributions", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_content_consumer_portrait", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "c5a3f32c5474" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/index/fetch_content_consumer_portrait", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_index_fetch_content_consumer_portrait", "method": "POST", "path": "/apis/v1/tikhub/douyin/index/fetch_content_consumer_portrait" }, "parameters": [ { "name": "end_date", "in": "query", "required": true, "schema": { "type": "string", "description": "End date in YYYYMMDD format. When `period=\"week\"`, this date must be a Sunday; when `period=\"month\"`, it must be the last day of the month.", "title": "End Date" }, "description": "End date in YYYYMMDD format. When `period=\"week\"`, this date must be a Sunday; when `period=\"month\"`, it must be the last day of the month." }, { "name": "period", "in": "query", "required": false, "schema": { "enum": [ "week", "month" ], "type": "string", "description": "Period: week or month\n\nUsage: \"week\" (end_date must be a Sunday) or \"month\" (end_date must be month-end, e.g. 20260331)", "default": "month", "title": "Period" }, "description": "Period: week or month\n\nUsage: \"week\" (end_date must be a Sunday) or \"month\" (end_date must be month-end, e.g. 20260331)" }, { "name": "tag_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Required category ID as a string. Call `GET /tikhub/douyin/index/fetch_item_filter_options` (operationId: `get_tikhub_douyin_index_fetch_item_filter_options`) and use an entry's `id` from the `categories` list in the response payload. Convert the ID to a string for `tag_id`. This endpoint does not accept `\"0\"` (all categories); select a specific category and exclude the entry with `id=0`.", "title": "Tag Id" }, "description": "Required category ID as a string. Call `GET /tikhub/douyin/index/fetch_item_filter_options` (operationId: `get_tikhub_douyin_index_fetch_item_filter_options`) and use an entry's `id` from the `categories` list in the response payload. Convert the ID to a string for `tag_id`. This endpoint does not accept `\"0\"` (all categories); select a specific category and exclude the entry with `id=0`." } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:4501626edc6701239a91f1df9652e03c7e16c99cec99bf0450f5d8994ce1aad8" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-index-fetch_content_consumer_portrait" } }, "/apis/v1/tikhub/douyin/index/fetch_content_creative_duration": { "post": { "description": "Douyin (index).\n\n### Purpose:\n- Get video duration distribution for a category\n- Helps understand creators' preferred video lengths in this category\n### Parameters:\n- tag_id: Required category ID as a string, excluding \"0\" (all categories). Obtain an entry's `id` from the `categories` list returned by `GET /tikhub/douyin/index/fetch_item_filter_options` (operationId: `get_tikhub_douyin_index_fetch_item_filter_options`).\n- period: \"week\" (end_date must be a Sunday) or \"month\" (end_date must be month-end)\n- end_date: End date YYYYMMDD, must align with period\n### Return:\n- Video count and ratio per duration bucket (e.g. 0-15s, 15-60s, 60-180s, >180s)\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_index_fetch_content_creative_duration", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Video count and ratio per duration bucket (e.g. 0-15s, 15-60s, 60-180s, >180s)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_content_creative_duration", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "70f5f4c9c77e" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/index/fetch_content_creative_duration", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_index_fetch_content_creative_duration", "method": "POST", "path": "/apis/v1/tikhub/douyin/index/fetch_content_creative_duration" }, "parameters": [ { "name": "end_date", "in": "query", "required": true, "schema": { "type": "string", "description": "End date in YYYYMMDD format. When `period=\"week\"`, this date must be a Sunday; when `period=\"month\"`, it must be the last day of the month.", "title": "End Date" }, "description": "End date in YYYYMMDD format. When `period=\"week\"`, this date must be a Sunday; when `period=\"month\"`, it must be the last day of the month." }, { "name": "period", "in": "query", "required": false, "schema": { "enum": [ "week", "month" ], "type": "string", "description": "Period: week=weekly, month=monthly\n\nUsage: \"week\" (end_date must be a Sunday) or \"month\" (end_date must be month-end)", "default": "week", "title": "Period" }, "description": "Period: week=weekly, month=monthly\n\nUsage: \"week\" (end_date must be a Sunday) or \"month\" (end_date must be month-end)" }, { "name": "tag_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Required category ID as a string. Call `GET /tikhub/douyin/index/fetch_item_filter_options` (operationId: `get_tikhub_douyin_index_fetch_item_filter_options`) and use an entry's `id` from the `categories` list in the response payload. Convert the ID to a string for `tag_id`. This endpoint does not accept `\"0\"` (all categories); select a specific category and exclude the entry with `id=0`.", "title": "Tag Id" }, "description": "Required category ID as a string. Call `GET /tikhub/douyin/index/fetch_item_filter_options` (operationId: `get_tikhub_douyin_index_fetch_item_filter_options`) and use an entry's `id` from the `categories` list in the response payload. Convert the ID to a string for `tag_id`. This endpoint does not accept `\"0\"` (all categories); select a specific category and exclude the entry with `id=0`." } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:675ef672e2304ce7aeac7c6da991b2a866ce7d128cfa943413a6a070b6474f97" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-index-fetch_content_creative_duration" } }, "/apis/v1/tikhub/douyin/index/fetch_content_creative_keyword_items": { "post": { "description": "Douyin (index).\n\n### Purpose:\n- Get videos related to a specific hot keyword in a category\n- Used to inspect which videos contribute to a hot keyword\n### Parameters:\n- tag_id: Category ID (same as category_id in fetch_item_query)\n- period: \"1\" / \"3\" / \"7\" days\n- end_date: End date YYYYMMDD. **Must be a Sunday only when period=7**; any day for period=1/3\n- keyword: Hot keyword (typically from fetch_content_creative_keywords)\n### Return:\n- List of videos related to the keyword\n\nAPI references: `fetch_content_creative_keywords` = `POST /tikhub/douyin/index/fetch_content_creative_keywords` (operationId: `post_tikhub_douyin_index_fetch_content_creative_keywords`); `fetch_item_query` = `POST /tikhub/douyin/index/fetch_item_query` (operationId: `post_tikhub_douyin_index_fetch_item_query`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_index_fetch_content_creative_keyword_items", "responses": { "200": { "description": "Successful Response\n\n### Return\n- List of videos related to the keyword", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_content_creative_keyword_items", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "1b4e1d308baf" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/index/fetch_content_creative_keyword_items", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_index_fetch_content_creative_keyword_items", "method": "POST", "path": "/apis/v1/tikhub/douyin/index/fetch_content_creative_keyword_items" }, "parameters": [ { "name": "end_date", "in": "query", "required": true, "schema": { "type": "string", "description": "End date YYYYMMDD (**must be a Sunday only when period=7**; any day for period=1/3)", "title": "End Date" }, "description": "End date YYYYMMDD (**must be a Sunday only when period=7**; any day for period=1/3)" }, { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Keyword (get from fetch_content_creative_keywords)\n\nAPI references: `fetch_content_creative_keywords` = `POST /tikhub/douyin/index/fetch_content_creative_keywords` (operationId: `post_tikhub_douyin_index_fetch_content_creative_keywords`).", "title": "Keyword" }, "description": "Keyword (get from fetch_content_creative_keywords)\n\nAPI references: `fetch_content_creative_keywords` = `POST /tikhub/douyin/index/fetch_content_creative_keywords` (operationId: `post_tikhub_douyin_index_fetch_content_creative_keywords`)." }, { "name": "period", "in": "query", "required": false, "schema": { "enum": [ "1", "3", "7" ], "type": "string", "description": "Period: 1, 3, 7", "default": "7", "title": "Period" }, "description": "Period: 1, 3, 7" }, { "name": "tag_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Category ID, required, does NOT support 0=all\n\nUsage: Category ID (same as category_id in fetch_item_query)\n\nAPI references: `fetch_item_query` = `POST /tikhub/douyin/index/fetch_item_query` (operationId: `post_tikhub_douyin_index_fetch_item_query`).", "title": "Tag Id" }, "description": "Category ID, required, does NOT support 0=all\n\nUsage: Category ID (same as category_id in fetch_item_query)\n\nAPI references: `fetch_item_query` = `POST /tikhub/douyin/index/fetch_item_query` (operationId: `post_tikhub_douyin_index_fetch_item_query`)." } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:7ef90ce6f23f7925c424c15c3a8b4363927143da496730021841b07d057d7a95" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-index-fetch_content_creative_keyword_items" } }, "/apis/v1/tikhub/douyin/index/fetch_content_creative_keywords": { "post": { "description": "Douyin (index).\n\n### Purpose\n- Get creative hot keywords for a category\n\n### Parameters\n- tag_id: Required category ID as a string, excluding \"0\" (all categories). Obtain an entry's `id` from the `categories` list returned by `GET /tikhub/douyin/index/fetch_item_filter_options` (operationId: `get_tikhub_douyin_index_fetch_item_filter_options`).\n - **This endpoint does NOT support \"0=all\", you must pass a specific category ID**\n (e.g. \"601\"=Drama, \"628\"=Food)\n - Full list via fetch_item_filter_options\n- period: \"1\"=last 1 day, \"3\"=last 3 days, \"7\"=last 7 days\n- end_date: End date YYYYMMDD. **Must be a Sunday only when period=7**; any day for period=1/3\n\nAPI references: `fetch_item_filter_options` = `GET /tikhub/douyin/index/fetch_item_filter_options` (operationId: `get_tikhub_douyin_index_fetch_item_filter_options`); `fetch_item_query` = `POST /tikhub/douyin/index/fetch_item_query` (operationId: `post_tikhub_douyin_index_fetch_item_query`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_index_fetch_content_creative_keywords", "responses": { "200": { "description": "Successful response. Returns popular keywords for the selected vertical category.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_content_creative_keywords", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "294eaf770024" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/index/fetch_content_creative_keywords", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_index_fetch_content_creative_keywords", "method": "POST", "path": "/apis/v1/tikhub/douyin/index/fetch_content_creative_keywords" }, "parameters": [ { "name": "end_date", "in": "query", "required": true, "schema": { "type": "string", "description": "End date YYYYMMDD (**must be a Sunday only when period=7**; any day for period=1/3)", "title": "End Date" }, "description": "End date YYYYMMDD (**must be a Sunday only when period=7**; any day for period=1/3)" }, { "name": "period", "in": "query", "required": false, "schema": { "enum": [ "1", "3", "7" ], "type": "string", "description": "Period: 1=last 1 day, 3=last 3 days, 7=last 7 days", "default": "7", "title": "Period" }, "description": "Period: 1=last 1 day, 3=last 3 days, 7=last 7 days" }, { "name": "tag_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Required category ID as a string. Call `GET /tikhub/douyin/index/fetch_item_filter_options` (operationId: `get_tikhub_douyin_index_fetch_item_filter_options`) and use an entry's `id` from the `categories` list in the response payload. Convert the ID to a string for `tag_id`. This endpoint does not accept `\"0\"` (all categories); select a specific category and exclude the entry with `id=0`.", "title": "Tag Id" }, "description": "Required category ID as a string. Call `GET /tikhub/douyin/index/fetch_item_filter_options` (operationId: `get_tikhub_douyin_index_fetch_item_filter_options`) and use an entry's `id` from the `categories` list in the response payload. Convert the ID to a string for `tag_id`. This endpoint does not accept `\"0\"` (all categories); select a specific category and exclude the entry with `id=0`." } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:85bc9137c147bd7554154eda7d857751a8519d9bf64164ad005da9fd204e3eb9" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-index-fetch_content_creative_keywords" } }, "/apis/v1/tikhub/douyin/index/fetch_content_creative_topic": { "post": { "description": "Douyin (index).\n\n### Purpose\n- Get creative hot topics for a category\n\n### Parameters\n- tag_id: Required category ID as a string, excluding \"0\" (all categories). Obtain an entry's `id` from the `categories` list returned by `GET /tikhub/douyin/index/fetch_item_filter_options` (operationId: `get_tikhub_douyin_index_fetch_item_filter_options`).\n - **This endpoint does NOT support \"0=all\", you must pass a specific category ID**\n (e.g. \"601\"=Drama, \"628\"=Food)\n - Full list via fetch_item_filter_options\n- period: \"1\" / \"3\" / \"7\"\n- end_date: End date YYYYMMDD. **Must be a Sunday only when period=7**; any day for period=1/3\n- rank_type: \"index\" or \"rise\"\n\nAPI references: `fetch_item_filter_options` = `GET /tikhub/douyin/index/fetch_item_filter_options` (operationId: `get_tikhub_douyin_index_fetch_item_filter_options`); `fetch_item_query` = `POST /tikhub/douyin/index/fetch_item_query` (operationId: `post_tikhub_douyin_index_fetch_item_query`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_index_fetch_content_creative_topic", "responses": { "200": { "description": "Successful response. Returns popular topics for the selected vertical category.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_content_creative_topic", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "9b361e449955" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/index/fetch_content_creative_topic", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_index_fetch_content_creative_topic", "method": "POST", "path": "/apis/v1/tikhub/douyin/index/fetch_content_creative_topic" }, "parameters": [ { "name": "end_date", "in": "query", "required": true, "schema": { "type": "string", "description": "End date YYYYMMDD (**must be a Sunday only when period=7**; any day for period=1/3)", "title": "End Date" }, "description": "End date YYYYMMDD (**must be a Sunday only when period=7**; any day for period=1/3)" }, { "name": "period", "in": "query", "required": false, "schema": { "enum": [ "1", "3", "7" ], "type": "string", "description": "Period: 1, 3, 7", "default": "7", "title": "Period" }, "description": "Period: 1, 3, 7" }, { "name": "rank_type", "in": "query", "required": false, "schema": { "enum": [ "index", "rise" ], "type": "string", "description": "Rank type: index=index sort, rise=rising sort", "default": "index", "title": "Rank Type" }, "description": "Rank type: index=index sort, rise=rising sort" }, { "name": "tag_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Required category ID as a string. Call `GET /tikhub/douyin/index/fetch_item_filter_options` (operationId: `get_tikhub_douyin_index_fetch_item_filter_options`) and use an entry's `id` from the `categories` list in the response payload. Convert the ID to a string for `tag_id`. This endpoint does not accept `\"0\"` (all categories); select a specific category and exclude the entry with `id=0`.", "title": "Tag Id" }, "description": "Required category ID as a string. Call `GET /tikhub/douyin/index/fetch_item_filter_options` (operationId: `get_tikhub_douyin_index_fetch_item_filter_options`) and use an entry's `id` from the `categories` list in the response payload. Convert the ID to a string for `tag_id`. This endpoint does not accept `\"0\"` (all categories); select a specific category and exclude the entry with `id=0`." } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:d5cf4cc72532ff547289cd206b83447afde9446140c132d9033c7b14c6e5843f" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-index-fetch_content_creative_topic" } }, "/apis/v1/tikhub/douyin/index/fetch_content_interact_trend": { "post": { "description": "Douyin (index).\n\n### Purpose:\n- Get interaction (like/comment/share/favorite) trend over time for a category\n- Measures user engagement intensity for content in this category\n### Parameters:\n- tag_id: Required category ID as a string, excluding \"0\" (all categories). Obtain an entry's `id` from the `categories` list returned by `GET /tikhub/douyin/index/fetch_item_filter_options` (operationId: `get_tikhub_douyin_index_fetch_item_filter_options`).\n- start_date: Start date YYYYMMDD (inclusive)\n- end_date: End date YYYYMMDD (inclusive)\n### Return:\n- Daily aggregated interaction data: like / comment / share / favorite totals per day\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_index_fetch_content_interact_trend", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Daily aggregated interaction data: like / comment / share / favorite totals per day", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_content_interact_trend", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "2904175ec2b4" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/index/fetch_content_interact_trend", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_index_fetch_content_interact_trend", "method": "POST", "path": "/apis/v1/tikhub/douyin/index/fetch_content_interact_trend" }, "parameters": [ { "name": "end_date", "in": "query", "required": true, "schema": { "type": "string", "description": "End date YYYYMMDD", "title": "End Date" }, "description": "End date YYYYMMDD" }, { "name": "start_date", "in": "query", "required": true, "schema": { "type": "string", "description": "Start date YYYYMMDD", "title": "Start Date" }, "description": "Start date YYYYMMDD" }, { "name": "tag_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Required category ID as a string. Call `GET /tikhub/douyin/index/fetch_item_filter_options` (operationId: `get_tikhub_douyin_index_fetch_item_filter_options`) and use an entry's `id` from the `categories` list in the response payload. Convert the ID to a string for `tag_id`. This endpoint does not accept `\"0\"` (all categories); select a specific category and exclude the entry with `id=0`.", "title": "Tag Id" }, "description": "Required category ID as a string. Call `GET /tikhub/douyin/index/fetch_item_filter_options` (operationId: `get_tikhub_douyin_index_fetch_item_filter_options`) and use an entry's `id` from the `categories` list in the response payload. Convert the ID to a string for `tag_id`. This endpoint does not accept `\"0\"` (all categories); select a specific category and exclude the entry with `id=0`." } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:00c4fd489e4846eb2e20c85664325f8833146f7b5a778014633e95e8e4a28fe2" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-index-fetch_content_interact_trend" } }, "/apis/v1/tikhub/douyin/index/fetch_content_publish_trend": { "get": { "description": "Douyin (index).\n\n### Purpose:\n- Get the content publish volume trend over time for a category\n- Helps understand content supply heat changes for a category\n### Parameters:\n- tag_id: Required category ID as a string, excluding \"0\" (all categories). Obtain an entry's `id` from the `categories` list returned by `GET /tikhub/douyin/index/fetch_item_filter_options` (operationId: `get_tikhub_douyin_index_fetch_item_filter_options`).\n- start_date: Start date YYYYMMDD (inclusive)\n- end_date: End date YYYYMMDD (inclusive)\n### Return:\n- Daily aggregated publish volume (date + count of items published that day)\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_index_fetch_content_publish_trend", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Daily aggregated publish volume (date + count of items published that day)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_content_publish_trend", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "c2a7222a3d99" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/index/fetch_content_publish_trend", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_index_fetch_content_publish_trend", "method": "GET", "path": "/apis/v1/tikhub/douyin/index/fetch_content_publish_trend" }, "parameters": [ { "name": "end_date", "in": "query", "required": true, "schema": { "type": "string", "description": "End date YYYYMMDD", "title": "End Date" }, "description": "End date YYYYMMDD" }, { "name": "start_date", "in": "query", "required": true, "schema": { "type": "string", "description": "Start date YYYYMMDD", "title": "Start Date" }, "description": "Start date YYYYMMDD" }, { "name": "tag_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Required category ID as a string. Call `GET /tikhub/douyin/index/fetch_item_filter_options` (operationId: `get_tikhub_douyin_index_fetch_item_filter_options`) and use an entry's `id` from the `categories` list in the response payload. Convert the ID to a string for `tag_id`. This endpoint does not accept `\"0\"` (all categories); select a specific category and exclude the entry with `id=0`.", "title": "Tag Id" }, "description": "Required category ID as a string. Call `GET /tikhub/douyin/index/fetch_item_filter_options` (operationId: `get_tikhub_douyin_index_fetch_item_filter_options`) and use an entry's `id` from the `categories` list in the response payload. Convert the ID to a string for `tag_id`. This endpoint does not accept `\"0\"` (all categories); select a specific category and exclude the entry with `id=0`." } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:5b1d05022e7e4b10983ee9b09a13ca67117a994560c8f0b6d3cd837e529bf5a0" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-index-fetch_content_publish_trend" } }, "/apis/v1/tikhub/douyin/index/fetch_content_valid_date": { "get": { "description": "Douyin (index).\n\n### Purpose:\n- Get valid date range for the creation guide section\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_index_fetch_content_valid_date", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_content_valid_date", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "e211e4fccaed" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/index/fetch_content_valid_date", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_index_fetch_content_valid_date", "method": "GET", "path": "/apis/v1/tikhub/douyin/index/fetch_content_valid_date" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e56c0f64759022cecb5502df30fd08faeb446c6d3a60cfc5fa77fb25dd390b27" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-index-fetch_content_valid_date" } }, "/apis/v1/tikhub/douyin/index/fetch_current_hot_topic": { "get": { "description": "Douyin (index).\n\n### Purpose:\n- Get Douyin real-time hot topics and trending topics leaderboard\n### Return:\n- Topic name, topic index, rank change and other information\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_index_fetch_current_hot_topic", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Topic name, topic index, rank change and other information", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_current_hot_topic", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "3081c6067043" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/index/fetch_current_hot_topic", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_index_fetch_current_hot_topic", "method": "GET", "path": "/apis/v1/tikhub/douyin/index/fetch_current_hot_topic" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:55aebe2722fa4ef9a7fd3be53035721e270bd0d43aaf324d4c6bca4b22720549" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-index-fetch_current_hot_topic" } }, "/apis/v1/tikhub/douyin/index/fetch_daren_compare_users_stable": { "post": { "description": "Douyin (index).\n\n### Purpose:\n- Compare trend data of multiple daren/creators (follower growth, engagement, etc.)\n### Parameters:\n- user_list: Daren uid list, comma separated, **max 5**\n- days: Comparison period, only 7 or 30\n### Return:\n- Trend data comparison for each daren in the specified period\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_index_fetch_daren_compare_users_stable", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Trend data comparison for each daren in the specified period", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_daren_compare_users_stable", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "58f8cfb88368" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/index/fetch_daren_compare_users_stable", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_index_fetch_daren_compare_users_stable", "method": "POST", "path": "/apis/v1/tikhub/douyin/index/fetch_daren_compare_users_stable" }, "parameters": [ { "name": "days", "in": "query", "required": false, "schema": { "enum": [ "7", "30" ], "type": "string", "description": "Days: 7 or 30", "default": "7", "title": "Days" }, "description": "Days: 7 or 30" }, { "name": "user_list", "in": "query", "required": true, "schema": { "type": "string", "description": "Daren uid list, comma separated, max 5", "title": "User List", "pattern": "^[^,]*(?:,[^,]*){0,4}$" }, "description": "Daren uid list, comma separated, max 5" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:06a6a67f19be3720c700df8dabecc634aecdd40af77c9c4cb5bacdc8b071857c" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-index-fetch_daren_compare_users_stable" } }, "/apis/v1/tikhub/douyin/index/fetch_daren_great_item_mile_info": { "post": { "description": "Douyin (index).\n\n### Purpose:\n- Get daren core metrics data\n### Parameters:\n- user_id: Douyin uid (numeric, e.g. \"3100268042915212\")\n### Return:\n- Follower count, like count, video count, engagement rate and other core metrics\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_index_fetch_daren_great_item_mile_info", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Follower count, like count, video count, engagement rate and other core metrics", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_daren_great_item_mile_info", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "9f3573b5560d" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/index/fetch_daren_great_item_mile_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_index_fetch_daren_great_item_mile_info", "method": "POST", "path": "/apis/v1/tikhub/douyin/index/fetch_daren_great_item_mile_info" }, "parameters": [ { "name": "user_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Douyin uid (numeric). Example: 3100268042915212", "title": "User Id" }, "description": "Douyin uid (numeric). Example: 3100268042915212" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:25ab1e755ad2bea122a72545148484a75304436dd56bf8c9cc9be3c484c5696f" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-index-fetch_daren_great_item_mile_info" } }, "/apis/v1/tikhub/douyin/index/fetch_daren_great_user_fans_info": { "post": { "description": "Douyin (index).\n\n### Purpose:\n- Get daren fans analysis data\n### Parameters:\n- user_id: Douyin uid (numeric, e.g. \"3100268042915212\")\n### Return:\n- Fans gender, age, region distribution, active time, etc.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_index_fetch_daren_great_user_fans_info", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Fans gender, age, region distribution, active time, etc.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_daren_great_user_fans_info", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "729310738abe" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/index/fetch_daren_great_user_fans_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_index_fetch_daren_great_user_fans_info", "method": "POST", "path": "/apis/v1/tikhub/douyin/index/fetch_daren_great_user_fans_info" }, "parameters": [ { "name": "user_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Douyin uid (numeric). Example: 3100268042915212", "title": "User Id" }, "description": "Douyin uid (numeric). Example: 3100268042915212" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:1b77359409fb68dbe794a1cc0ef2b943ad311d1bb63fd54607e77e04a4bee210" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-index-fetch_daren_great_user_fans_info" } }, "/apis/v1/tikhub/douyin/index/fetch_daren_great_user_top_video": { "post": { "description": "Douyin (index).\n\n### Purpose:\n- Get daren's top video list in a specified time range\n### Parameters:\n- user_id: Douyin uid (numeric, e.g. \"3100268042915212\")\n- start_date: Start date, format YYYYMMDD\n- end_date: End date, format YYYYMMDD\n### Note:\n- **Date range must not exceed 30 days**, otherwise the API will return an error\n### Return:\n- Daren's top video list (play count, like count, etc.)\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_index_fetch_daren_great_user_top_video", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Daren's top video list (play count, like count, etc.)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_daren_great_user_top_video", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "ad434b0b22bf" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/index/fetch_daren_great_user_top_video", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_index_fetch_daren_great_user_top_video", "method": "POST", "path": "/apis/v1/tikhub/douyin/index/fetch_daren_great_user_top_video" }, "parameters": [ { "name": "end_date", "in": "query", "required": true, "schema": { "type": "string", "description": "End date YYYYMMDD", "title": "End Date" }, "description": "End date YYYYMMDD" }, { "name": "start_date", "in": "query", "required": true, "schema": { "type": "string", "description": "Start date YYYYMMDD", "title": "Start Date" }, "description": "Start date YYYYMMDD" }, { "name": "user_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Douyin uid (numeric). Example: 3100268042915212", "title": "User Id" }, "description": "Douyin uid (numeric). Example: 3100268042915212" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:32a8df449238382c308f73f1fc2a1453893d47986b558db45754802b4fefd739" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-index-fetch_daren_great_user_top_video" } }, "/apis/v1/tikhub/douyin/index/fetch_daren_similar_users": { "post": { "description": "Douyin (index).\n\n### Purpose:\n- Get similar daren/creators to a specified user\n### Parameters:\n- user_id: Douyin uid (numeric, e.g. \"3100268042915212\")\n### Return:\n- List of similar daren\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_index_fetch_daren_similar_users", "responses": { "200": { "description": "Successful Response\n\n### Return\n- List of similar daren", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_daren_similar_users", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "71e459a42b91" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/index/fetch_daren_similar_users", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_index_fetch_daren_similar_users", "method": "POST", "path": "/apis/v1/tikhub/douyin/index/fetch_daren_similar_users" }, "parameters": [ { "name": "user_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Douyin uid (numeric). Example: 3100268042915212", "title": "User Id" }, "description": "Douyin uid (numeric). Example: 3100268042915212" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:14262aa5d66c9e5395516c147046d531c520a30ce8c9f4ecff53aa1e394f3c66" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-index-fetch_daren_similar_users" } }, "/apis/v1/tikhub/douyin/index/fetch_daren_sug_great_user_list": { "post": { "description": "Douyin (index).\n\n### Purpose:\n- Search for daren/creators, get suggestion list\n### Parameters:\n- keyword: Daren nickname keyword\n- total: Return count, default 20\n### Return:\n- Matched daren list (includes user ID, nickname, avatar, follower count, etc.)\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_index_fetch_daren_sug_great_user_list", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Matched daren list (includes user ID, nickname, avatar, follower count, etc.)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_daren_sug_great_user_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "f3fdc7fc7462" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/index/fetch_daren_sug_great_user_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_index_fetch_daren_sug_great_user_list", "method": "POST", "path": "/apis/v1/tikhub/douyin/index/fetch_daren_sug_great_user_list" }, "parameters": [ { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Search keyword", "title": "Keyword" }, "description": "Search keyword" }, { "name": "total", "in": "query", "required": false, "schema": { "type": "string", "description": "Return count, default 20", "default": "20", "title": "Total" }, "description": "Return count, default 20" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:c8a82ad307f1906c04b6841ce5e671037c91ad3a0d2248332681aa5a45189413" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-index-fetch_daren_sug_great_user_list" } }, "/apis/v1/tikhub/douyin/index/fetch_encrypt_user_id": { "get": { "description": "Douyin (index).\n\n### Purpose:\n- Convert a Douyin uid (numeric) to the encrypted user_id used internally by Douyin Index API\n- The daren-related endpoints already handle this conversion automatically,\n so you usually do NOT need to call this endpoint manually\n- Only useful for debugging or when you need the encrypted user_id directly\n### Parameters:\n- uid: Douyin uid, numeric string\n### Return:\n- uid: Original input uid\n- user_id: Encrypted user_id\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_index_fetch_encrypt_user_id", "responses": { "200": { "description": "Successful Response\n\n### Return\n- uid: Original input uid\n- user_id: Encrypted user_id", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_encrypt_user_id", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "3ac6e8f732ab" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/index/fetch_encrypt_user_id", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_index_fetch_encrypt_user_id", "method": "GET", "path": "/apis/v1/tikhub/douyin/index/fetch_encrypt_user_id" }, "parameters": [ { "name": "uid", "in": "query", "required": true, "schema": { "type": "string", "description": "Douyin uid (numeric). Example: 3100268042915212", "title": "Uid" }, "description": "Douyin uid (numeric). Example: 3100268042915212" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:78badb2d4c7b5ef0f485764c9743fa44b79ccd97c1e9acce146663d100132726" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-index-fetch_encrypt_user_id" } }, "/apis/v1/tikhub/douyin/index/fetch_get_user_sub_word": { "post": { "description": "Douyin (index).\n\n### Purpose:\n- Get subscribed keyword list for the current logged-in user in Douyin Index\n### Return:\n- List of keywords subscribed by the user\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_index_fetch_get_user_sub_word", "responses": { "200": { "description": "Successful Response\n\n### Return\n- List of keywords subscribed by the user", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_get_user_sub_word", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "e63a6c81dae0" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/index/fetch_get_user_sub_word", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_index_fetch_get_user_sub_word", "method": "POST", "path": "/apis/v1/tikhub/douyin/index/fetch_get_user_sub_word" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:8a164e1e4144da24517a13070b31c21b21b72863a683862c3a29650baa94da35" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-index-fetch_get_user_sub_word" } }, "/apis/v1/tikhub/douyin/index/fetch_hot_detail": { "get": { "description": "Douyin (index).\n\n### Purpose:\n- Get full analysis of a single hot topic; one request covers every module\n of the hot topic detail page\n### Parameters:\n- topic_name: Hot topic name, obtained from fetch_current_hot_topic results\n### Return:\n- trend_item: Hot index trend (index value per timestamp)\n- content_item: Hot content list (video title, url, cover, author, digg/comment counts)\n- play_rank_author_item: Related creators ranked by play count\n- digg_rank_author_item: Related creators ranked by digg count\n- fans_rank_author_item: Related creators ranked by fans count\n- comment_rank_author_item: Related creators ranked by comment count\n- portrait: Audience portrait with four dimensions - province, city, gender, age;\n each label value is a percentage in decimal form\n\nAPI references: `fetch_current_hot_topic` = `GET /tikhub/douyin/index/fetch_current_hot_topic` (operationId: `get_tikhub_douyin_index_fetch_current_hot_topic`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_index_fetch_hot_detail", "responses": { "200": { "description": "Successful Response\n\n### Return\n- trend_item: Hot index trend (index value per timestamp)\n- content_item: Hot content list (video title, url, cover, author, digg/comment counts)\n- play_rank_author_item: Related creators ranked by play count\n- digg_rank_author_item: Related creators ranked by digg count\n- fans_rank_author_item: Related creators ranked by fans count\n- comment_rank_author_item: Related creators ranked by comment count\n- portrait: Audience portrait with four dimensions - province, city, gender, age;\n each label value is a percentage in decimal form", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_hot_detail", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "0944974fe438" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/index/fetch_hot_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_index_fetch_hot_detail", "method": "GET", "path": "/apis/v1/tikhub/douyin/index/fetch_hot_detail" }, "parameters": [ { "name": "topic_name", "in": "query", "required": true, "schema": { "type": "string", "description": "Hot topic name, obtained from fetch_current_hot_topic results\n\nAPI references: `fetch_current_hot_topic` = `GET /tikhub/douyin/index/fetch_current_hot_topic` (operationId: `get_tikhub_douyin_index_fetch_current_hot_topic`).", "title": "Topic Name" }, "description": "Hot topic name, obtained from fetch_current_hot_topic results\n\nAPI references: `fetch_current_hot_topic` = `GET /tikhub/douyin/index/fetch_current_hot_topic` (operationId: `get_tikhub_douyin_index_fetch_current_hot_topic`)." } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:43aff11ae3afc509a7c76a46a4a6b34339aeee34a34873f272bf1e584cd0f60f" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-index-fetch_hot_detail" } }, "/apis/v1/tikhub/douyin/index/fetch_hot_trend_word": { "get": { "description": "Douyin (index).\n\n### Purpose:\n- Get hot trend words suggested in the keyword index search box, used as input\n suggestions for keyword index analysis\n- Note: This is NOT the real-time hot topic leaderboard. For real-time and\n rocketing hot topics use fetch_current_hot_topic\n### Parameters:\n- app_name: Platform, aweme=Douyin, toutiao=Toutiao (toutiao currently returns empty)\n- type: Word type, 0=search words (plain words, id is always \"0\"),\n 1=content words (with topic id)\n### Return:\n- update_time: Data update date (updated daily, not real-time)\n- trend_words: Word list with id and word\n\nAPI references: `fetch_current_hot_topic` = `GET /tikhub/douyin/index/fetch_current_hot_topic` (operationId: `get_tikhub_douyin_index_fetch_current_hot_topic`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_index_fetch_hot_trend_word", "responses": { "200": { "description": "Successful Response\n\n### Return\n- update_time: Data update date (updated daily, not real-time)\n- trend_words: Word list with id and word", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_hot_trend_word", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "f5917c9056f7" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/index/fetch_hot_trend_word", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_index_fetch_hot_trend_word", "method": "GET", "path": "/apis/v1/tikhub/douyin/index/fetch_hot_trend_word" }, "parameters": [ { "name": "app_name", "in": "query", "required": false, "schema": { "enum": [ "aweme", "toutiao" ], "type": "string", "description": "Platform, aweme=Douyin, toutiao=Toutiao (toutiao currently returns empty)", "default": "aweme", "title": "App Name" }, "description": "Platform, aweme=Douyin, toutiao=Toutiao (toutiao currently returns empty)" }, { "name": "type", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 1, "minimum": 0, "description": "Word type: 0=Search hot words, 1=Content hot words\n\nUsage: Word type, 0=search words (plain words, id is always \"0\"),\n 1=content words (with topic id)", "default": 0, "title": "Type" }, "description": "Word type: 0=Search hot words, 1=Content hot words\n\nUsage: Word type, 0=search words (plain words, id is always \"0\"),\n 1=content words (with topic id)" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e94ca168e54a31ef1b6f1a307132deb458d5acc67b3292b7c30c849b8f40c075" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-index-fetch_hot_trend_word" } }, "/apis/v1/tikhub/douyin/index/fetch_hot_words": { "get": { "description": "Douyin (index).\n\n### Purpose:\n- Get current hot search keywords list\n### Parameters:\n- app_name: Platform, aweme=Douyin, toutiao=Toutiao\n### Return:\n- Keyword name, search index, growth rate, etc.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_index_fetch_hot_words", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Keyword name, search index, growth rate, etc.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_hot_words", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "8154d3b8edcb" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/index/fetch_hot_words", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_index_fetch_hot_words", "method": "GET", "path": "/apis/v1/tikhub/douyin/index/fetch_hot_words" }, "parameters": [ { "name": "app_name", "in": "query", "required": false, "schema": { "enum": [ "aweme", "toutiao" ], "type": "string", "description": "Platform: aweme (Douyin), toutiao (Toutiao)", "default": "aweme", "title": "App Name" }, "description": "Platform: aweme (Douyin), toutiao (Toutiao)" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:05aaa4a1067bc6d4cd150b29da117ca0a458ad6e65f516c68583c210d6a875c8" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-index-fetch_hot_words" } }, "/apis/v1/tikhub/douyin/index/fetch_insight_get_rec": { "get": { "description": "Douyin (index).\n\n### Purpose:\n- Get related insight recommendations based on a current report ID\n- Typically used for the \"Related\" module on a report detail page\n### Parameters:\n- report_id: ID of the report currently being viewed (from fetch_report_search\n or fetch_insight_recommend)\n### Return:\n- List of related recommended reports (id, title, cover, publish time, etc.)\n\nAPI references: `fetch_insight_recommend` = `GET /tikhub/douyin/index/fetch_insight_recommend` (operationId: `get_tikhub_douyin_index_fetch_insight_recommend`); `fetch_report_search` = `POST /tikhub/douyin/index/fetch_report_search` (operationId: `post_tikhub_douyin_index_fetch_report_search`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_index_fetch_insight_get_rec", "responses": { "200": { "description": "Successful Response\n\n### Return\n- List of related recommended reports (id, title, cover, publish time, etc.)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_insight_get_rec", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "8ed0ee4179a8" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/index/fetch_insight_get_rec", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_index_fetch_insight_get_rec", "method": "GET", "path": "/apis/v1/tikhub/douyin/index/fetch_insight_get_rec" }, "parameters": [ { "name": "report_id", "in": "query", "required": true, "schema": { "type": "string", "description": "ID of the report currently being viewed (from fetch_report_search\n or fetch_insight_recommend)\n\nAPI references: `fetch_insight_recommend` = `GET /tikhub/douyin/index/fetch_insight_recommend` (operationId: `get_tikhub_douyin_index_fetch_insight_recommend`); `fetch_report_search` = `POST /tikhub/douyin/index/fetch_report_search` (operationId: `post_tikhub_douyin_index_fetch_report_search`).", "title": "Report Id" }, "description": "ID of the report currently being viewed (from fetch_report_search\n or fetch_insight_recommend)\n\nAPI references: `fetch_insight_recommend` = `GET /tikhub/douyin/index/fetch_insight_recommend` (operationId: `get_tikhub_douyin_index_fetch_insight_recommend`); `fetch_report_search` = `POST /tikhub/douyin/index/fetch_report_search` (operationId: `post_tikhub_douyin_index_fetch_report_search`)." } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:4b9e18a1a4a20c59a67784652201da0b92cc1d2252987689337a082c68c1a2a1" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-index-fetch_insight_get_rec" } }, "/apis/v1/tikhub/douyin/index/fetch_insight_recommend": { "get": { "description": "Douyin (index).\n\n### Purpose:\n- Get the list of recommended trend insight reports on the home page\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_index_fetch_insight_recommend", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_insight_recommend", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "cda5f74f4fbc" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/index/fetch_insight_recommend", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_index_fetch_insight_recommend", "method": "GET", "path": "/apis/v1/tikhub/douyin/index/fetch_insight_recommend" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e56c0f64759022cecb5502df30fd08faeb446c6d3a60cfc5fa77fb25dd390b27" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-index-fetch_insight_recommend" } }, "/apis/v1/tikhub/douyin/index/fetch_item_analysis": { "post": { "description": "Douyin (index).\n\n### Purpose\n- Get comparison analysis for a video (performance vs. similar videos / benchmark)\n\n### Parameters\n- item_id: Video ID (Douyin aweme id, numeric string)\n- start_date/end_date: Date range in YYYYMMDD\n\n### Return\n- Comparison analysis of the video against reference targets across dimensions\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_index_fetch_item_analysis", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Comparison analysis of the video against reference targets across dimensions", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_item_analysis", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "14996fbbf21e" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/index/fetch_item_analysis", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_index_fetch_item_analysis", "method": "POST", "path": "/apis/v1/tikhub/douyin/index/fetch_item_analysis" }, "parameters": [ { "name": "end_date", "in": "query", "required": true, "schema": { "type": "string", "description": "End date YYYYMMDD", "title": "End Date" }, "description": "End date YYYYMMDD" }, { "name": "item_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Video ID (Douyin aweme id, numeric). Example: 7660090930283744575", "title": "Item Id" }, "description": "Video ID (Douyin aweme id, numeric). Example: 7660090930283744575" }, { "name": "start_date", "in": "query", "required": true, "schema": { "type": "string", "description": "Start date YYYYMMDD", "title": "Start Date" }, "description": "Start date YYYYMMDD" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:a29389deb7702616b5e17294ef3b1d4e29a74f2fd5a7456beb42b2b44b5ef777" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-index-fetch_item_analysis" } }, "/apis/v1/tikhub/douyin/index/fetch_item_base": { "post": { "description": "Douyin (index).\n\n### Purpose:\n- Get the basic detail of a video in Douyin Index video analysis\n### Parameters:\n- item_id: Video ID (Douyin aweme id, numeric string)\n### Return:\n- Video title, cover, duration, publish time, author info and basic metrics\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_index_fetch_item_base", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Video title, cover, duration, publish time, author info and basic metrics", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_item_base", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "69a6021d5e6a" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/index/fetch_item_base", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_index_fetch_item_base", "method": "POST", "path": "/apis/v1/tikhub/douyin/index/fetch_item_base" }, "parameters": [ { "name": "item_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Video ID (Douyin aweme id, numeric). Example: 7660090930283744575", "title": "Item Id" }, "description": "Video ID (Douyin aweme id, numeric). Example: 7660090930283744575" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:3e6bfb5ecb32e3379b093ab8bc69a0b821c88531a9985fda2eee77a34332ac4e" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-index-fetch_item_base" } }, "/apis/v1/tikhub/douyin/index/fetch_item_filter_options": { "get": { "description": "Douyin (index).\n\n### Purpose:\n- Get all supported filter values for the `POST /tikhub/douyin/index/fetch_item_query` (operationId: `post_tikhub_douyin_index_fetch_item_query`) video search endpoint\n- Returns: categories, duration_types, label_types, date_types\n- Use this endpoint to discover valid IDs before calling `POST /tikhub/douyin/index/fetch_item_query` (operationId: `post_tikhub_douyin_index_fetch_item_query`)\n### Return:\n- categories: Category list (id / name / name_en), id is used for category_id parameter\n- duration_types: Duration list (id / name / name_en), id is used for duration_type parameter\n- label_types: Label/type list (id / name / name_en), id is used for label_type parameter\n- date_types: Publish date list (id / name / name_en), id is used for date_type parameter\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_index_fetch_item_filter_options", "responses": { "200": { "description": "Successful Response\n\n### Return\n- categories: Category list (id / name / name_en), id is used for category_id parameter\n- duration_types: Duration list (id / name / name_en), id is used for duration_type parameter\n- label_types: Label/type list (id / name / name_en), id is used for label_type parameter\n- date_types: Publish date list (id / name / name_en), id is used for date_type parameter", "content": { "application/json": { "schema": { "properties": { "code": { "type": "integer", "title": "Code", "description": "HTTP status code", "default": 200 }, "request_id": { "title": "Request Id", "description": "Unique request identifier", "type": [ "string", "null" ] }, "message": { "type": "string", "title": "Message", "description": "Response message (EN-US)", "default": "Request successful. This request will incur a charge." }, "message_zh": { "type": "string", "title": "Message Zh", "description": "Response message (ZH-CN)", "default": "请求成功，本次请求将被计费。" }, "support": { "type": "string", "title": "Support", "description": "Support message", "default": "Discord: https://discord.gg/aMEAS8Xsvz" }, "time": { "type": "string", "title": "Time", "description": "The time the response was generated" }, "time_stamp": { "type": "integer", "title": "Time Stamp", "description": "The timestamp the response was generated" }, "time_zone": { "type": "string", "title": "Time Zone", "description": "The timezone of the response time", "default": "America/Los_Angeles" }, "docs": { "title": "Docs", "description": "Link to the API Swagger documentation for this endpoint", "type": [ "string", "null" ] }, "cache_message": { "title": "Cache Message", "description": "Cache message (EN-US)", "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.", "type": [ "string", "null" ] }, "cache_message_zh": { "title": "Cache Message Zh", "description": "Cache message (ZH-CN)", "default": "本次响应已缓存，可通过下方 URL 直接查看，有效期 24 小时，访问缓存链接无额外费用。缓存仅用于请求溯源，不影响接口数据的时效性，也不会再次通过接口返回。", "type": [ "string", "null" ] }, "cache_url": { "title": "Cache Url", "description": "The URL to access the cached result", "type": [ "string", "null" ] }, "router": { "type": "string", "title": "Router", "description": "The endpoint that generated this response", "default": "" }, "params": { "title": "Params", "description": "The parameters used in the request", "default": {} }, "data": { "type": [ "object", "null" ], "description": "Documented filter dictionaries. Properties are optional because the official document does not declare required response fields.", "properties": { "categories": { "type": "array", "description": "Filter options; use each entry's `id` for `category_id`.", "items": { "type": "object", "properties": { "id": { "description": "Filter identifier; its response JSON type is not specified by the official documentation." }, "name": { "description": "Original option label. Preserve it verbatim." }, "name_en": { "description": "English option label." } } } }, "duration_types": { "type": "array", "description": "Filter options; use each entry's `id` for `duration_type`.", "items": { "type": "object", "properties": { "id": { "description": "Filter identifier; its response JSON type is not specified by the official documentation." }, "name": { "description": "Original option label. Preserve it verbatim." }, "name_en": { "description": "English option label." } } } }, "label_types": { "type": "array", "description": "Filter options; use each entry's `id` for `label_type`.", "items": { "type": "object", "properties": { "id": { "description": "Filter identifier; its response JSON type is not specified by the official documentation." }, "name": { "description": "Original option label. Preserve it verbatim." }, "name_en": { "description": "English option label." } } } }, "date_types": { "type": "array", "description": "Filter options; use each entry's `id` for `date_type`.", "items": { "type": "object", "properties": { "id": { "description": "Filter identifier; its response JSON type is not specified by the official documentation." }, "name": { "description": "Original option label. Preserve it verbatim." }, "name_en": { "description": "English option label." } } } } } } }, "type": "object", "title": "ResponseModel", "description": "Shared response envelope with the documented video-search filter dictionaries under data." } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_item_filter_options", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "68779cac6c59" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/index/fetch_item_filter_options", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_index_fetch_item_filter_options", "method": "GET", "path": "/apis/v1/tikhub/douyin/index/fetch_item_filter_options" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:d67140caf57528b9602d73749280e41488ee69510bad64dacfebaa7f173c1a72" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-index-fetch_item_filter_options" } }, "/apis/v1/tikhub/douyin/index/fetch_item_index": { "post": { "description": "Douyin (index).\n\n### Purpose\n- Get the video index trend for a video over a date range\n\n### Parameters\n- item_id: Video ID (Douyin aweme id, numeric string)\n- start_date/end_date: Date range in YYYYMMDD\n\n### Return\n- Video index (composite / spread / interaction, etc.) trend data over time\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_index_fetch_item_index", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Video index (composite / spread / interaction, etc.) trend data over time", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_item_index", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "d8ddf92176cc" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/index/fetch_item_index", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_index_fetch_item_index", "method": "POST", "path": "/apis/v1/tikhub/douyin/index/fetch_item_index" }, "parameters": [ { "name": "end_date", "in": "query", "required": true, "schema": { "type": "string", "description": "End date YYYYMMDD", "title": "End Date" }, "description": "End date YYYYMMDD" }, { "name": "item_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Video ID (Douyin aweme id, numeric). Example: 7660090930283744575", "title": "Item Id" }, "description": "Video ID (Douyin aweme id, numeric). Example: 7660090930283744575" }, { "name": "start_date", "in": "query", "required": true, "schema": { "type": "string", "description": "Start date YYYYMMDD", "title": "Start Date" }, "description": "Start date YYYYMMDD" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:d4e8a95a8877dad8cdc3d90e1c33ae1ebba98166fc42d8012727a70bd34cb32f" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-index-fetch_item_index" } }, "/apis/v1/tikhub/douyin/index/fetch_item_index_interpret": { "post": { "description": "Douyin (index).\n\n### Purpose\n- Get the interpretation of a video's index (breakdown of each sub-index)\n- Recommended to use together with fetch_item_index\n\n### Parameters\n- item_id: Video ID (Douyin aweme id, numeric string)\n- start_date/end_date: Date range in YYYYMMDD\n\n### Return\n- Interpretation of composite / spread / interaction sub-indices\n\nAPI references: `fetch_item_index` = `POST /tikhub/douyin/index/fetch_item_index` (operationId: `post_tikhub_douyin_index_fetch_item_index`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_index_fetch_item_index_interpret", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Interpretation of composite / spread / interaction sub-indices", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_item_index_interpret", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "3c4a11ad5437" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/index/fetch_item_index_interpret", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_index_fetch_item_index_interpret", "method": "POST", "path": "/apis/v1/tikhub/douyin/index/fetch_item_index_interpret" }, "parameters": [ { "name": "end_date", "in": "query", "required": true, "schema": { "type": "string", "description": "End date YYYYMMDD", "title": "End Date" }, "description": "End date YYYYMMDD" }, { "name": "item_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Video ID (Douyin aweme id, numeric). Example: 7660090930283744575", "title": "Item Id" }, "description": "Video ID (Douyin aweme id, numeric). Example: 7660090930283744575" }, { "name": "start_date", "in": "query", "required": true, "schema": { "type": "string", "description": "Start date YYYYMMDD", "title": "Start Date" }, "description": "Start date YYYYMMDD" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:195464deffddfac339297b3bdc2a3ce48b7a1531bfef68dec12ee050568482e6" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-index-fetch_item_index_interpret" } }, "/apis/v1/tikhub/douyin/index/fetch_item_query": { "post": { "description": "Douyin (index).\n\n### Purpose\n- Search the Douyin Index video library with 4-dimensional filters:\n category, duration, label type, publish date\n- Results contain basic video info plus core metrics (plays, likes, followers, etc.)\n\n### Parameters\n- query: Search keyword (required), e.g. \"food\"\n- category_id: Category ID (string), default \"0\"=all\n - Common examples: 601=Drama, 602=Celebrity, 603=Variety, 604=Movie, 605=TV Series,\n 606=Music, 607=Anime, 608=Games, 615=Tech, 628=Food, 629=Travel, 631=Fashion\n - Full list available via `GET /tikhub/douyin/index/fetch_item_filter_options` (operationId: `get_tikhub_douyin_index_fetch_item_filter_options`); use the id of a categories entry\n- date_type: Publish date filter, default 0=any\n - Valid values: 0=any, 3=last 3 days, 7=last 7 days, 30=last 30 days\n- label_type: Video type (quality tag), default 0=any\n - Valid values: 0=any, 1=low-follower hit, 2=high completion rate,\n 3=high follower growth, 4=high like rate\n- duration_type: Duration filter, default 0=any\n - Valid values: 0=any, 1=0-15s, 6=15-60s, 7=60-120s, 8=120-180s, 9=over 180s\n\n### Note\n- All filter values can be fetched dynamically via `GET /tikhub/douyin/index/fetch_item_filter_options` (operationId: `get_tikhub_douyin_index_fetch_item_filter_options`)\n to avoid hard-coded outdated data.\n\n### Return\n- Video list. Each item contains: itemId, itemTitle, cover, duration, publish time,\n play count, like count, comment count, share count, author id/nickname/followers, etc.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_index_fetch_item_query", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Video list. Each item contains: itemId, itemTitle, cover, duration, publish time,\n play count, like count, comment count, share count, author id/nickname/followers, etc.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_item_query", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "edc6b9773bc5" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/index/fetch_item_query", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_index_fetch_item_query", "method": "POST", "path": "/apis/v1/tikhub/douyin/index/fetch_item_query" }, "parameters": [ { "name": "category_id", "in": "query", "required": false, "schema": { "type": "string", "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.", "default": "0", "title": "Category Id" }, "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." }, { "name": "date_type", "in": "query", "required": false, "schema": { "type": "integer", "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.", "default": 0, "title": "Date Type" }, "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." }, { "name": "duration_type", "in": "query", "required": false, "schema": { "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.", "default": 0, "title": "Duration Type" }, "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." }, { "name": "label_type", "in": "query", "required": false, "schema": { "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.", "default": 0, "title": "Label Type" }, "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." }, { "name": "query", "in": "query", "required": true, "schema": { "type": "string", "description": "Search keyword", "title": "Query" }, "description": "Search keyword" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:fdee4a6771e16faad5470a215769dabf33a685854612d108ff50814b53942a2f" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-index-fetch_item_query" } }, "/apis/v1/tikhub/douyin/index/fetch_item_sug": { "post": { "description": "Douyin (index).\n\n### Purpose:\n- Get keyword auto-complete suggestions for video search\n### Parameters:\n- query: Search keyword\n### Return:\n- Matched keyword suggestion list\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_index_fetch_item_sug", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Matched keyword suggestion list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_item_sug", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "0df7b1c12735" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/index/fetch_item_sug", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_index_fetch_item_sug", "method": "POST", "path": "/apis/v1/tikhub/douyin/index/fetch_item_sug" }, "parameters": [ { "name": "query", "in": "query", "required": true, "schema": { "type": "string", "description": "Search keyword", "title": "Query" }, "description": "Search keyword" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:6163039afa171b2550edff099173a4d667988347682be4583a1aa0c1bd51083e" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-index-fetch_item_sug" } }, "/apis/v1/tikhub/douyin/index/fetch_item_user_profile": { "post": { "description": "Douyin (index).\n\n### Purpose\n- Get the audience portrait for a video\n\n### Parameters\n- item_id: Video ID (Douyin aweme id, numeric string)\n- start_date/end_date: Date range in YYYYMMDD\n\n### Return\n- Audience gender, age, region, interest distributions and other portrait data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_index_fetch_item_user_profile", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Audience gender, age, region, interest distributions and other portrait data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_item_user_profile", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "cd79b99453ee" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/index/fetch_item_user_profile", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_index_fetch_item_user_profile", "method": "POST", "path": "/apis/v1/tikhub/douyin/index/fetch_item_user_profile" }, "parameters": [ { "name": "end_date", "in": "query", "required": true, "schema": { "type": "string", "description": "End date YYYYMMDD", "title": "End Date" }, "description": "End date YYYYMMDD" }, { "name": "item_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Video ID (Douyin aweme id, numeric). Example: 7660090930283744575", "title": "Item Id" }, "description": "Video ID (Douyin aweme id, numeric). Example: 7660090930283744575" }, { "name": "start_date", "in": "query", "required": true, "schema": { "type": "string", "description": "Start date YYYYMMDD", "title": "Start Date" }, "description": "Start date YYYYMMDD" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:b6e19534b0b1ae6ff92a658d7d1378830f603b03466955178f9af17cbb101362" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-index-fetch_item_user_profile" } }, "/apis/v1/tikhub/douyin/index/fetch_keyword_valid_date": { "post": { "description": "Douyin (index).\n\n### Purpose\n- Get valid date range for specified keywords in Douyin Index\n\n### Parameters\n- keyword_list: Keyword list, comma separated, e.g. \"food,travel\"\n\n### Return\n- Queryable start and end dates for each keyword\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_index_fetch_keyword_valid_date", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Queryable start and end dates for each keyword", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_keyword_valid_date", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "4d470bd391e5" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/index/fetch_keyword_valid_date", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_index_fetch_keyword_valid_date", "method": "POST", "path": "/apis/v1/tikhub/douyin/index/fetch_keyword_valid_date" }, "parameters": [ { "name": "keyword_list", "in": "query", "required": true, "schema": { "type": "string", "description": "Keyword list, comma separated", "title": "Keyword List" }, "description": "Keyword list, comma separated" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:8980dbce013210cd0b7d8444de03213ac42bf396b2ca3f4b350aa2c8a6d2d664" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-index-fetch_keyword_valid_date" } }, "/apis/v1/tikhub/douyin/index/fetch_multi_keyword_hot_trend": { "post": { "description": "Douyin (index).\n\n### Purpose\n- Get hot trend data for multiple keywords in a specified time range\n- Compare hot trend changes of multiple keywords\n\n### Parameters\n- keyword_list: Comma separated keywords, e.g. \"food,travel\"\n- start_date: Start date, format YYYYMMDD\n- end_date: End date, format YYYYMMDD\n- app_name: Platform, aweme=Douyin, toutiao=Toutiao\n- region: Region filter, comma separated (e.g. \"云南,上海\"), empty for all\n\n### Return\n- Daily hot trend data\n\nRegion names are protocol values; use the original Chinese names.\n\n\nPublished reference price: $0.003 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_index_fetch_multi_keyword_hot_trend", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Daily hot trend data\n\nRegion names are protocol values; use the original Chinese names.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_multi_keyword_hot_trend", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.003, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "41f933f28089" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/index/fetch_multi_keyword_hot_trend", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_index_fetch_multi_keyword_hot_trend", "method": "POST", "path": "/apis/v1/tikhub/douyin/index/fetch_multi_keyword_hot_trend" }, "parameters": [ { "name": "app_name", "in": "query", "required": false, "schema": { "enum": [ "aweme", "toutiao" ], "type": "string", "description": "Platform: aweme (Douyin), toutiao (Toutiao)", "default": "aweme", "title": "App Name" }, "description": "Platform: aweme (Douyin), toutiao (Toutiao)" }, { "name": "end_date", "in": "query", "required": true, "schema": { "type": "string", "description": "End date, YYYYMMDD", "title": "End Date" }, "description": "End date, YYYYMMDD" }, { "name": "keyword_list", "in": "query", "required": true, "schema": { "type": "string", "description": "Keyword list, comma separated", "title": "Keyword List" }, "description": "Keyword list, comma separated" }, { "name": "region", "in": "query", "required": false, "schema": { "type": "string", "description": "Region list, comma separated", "default": "", "title": "Region" }, "description": "Region list, comma separated" }, { "name": "start_date", "in": "query", "required": true, "schema": { "type": "string", "description": "Start date, YYYYMMDD", "title": "Start Date" }, "description": "Start date, YYYYMMDD" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:b4f69d634de1090988c286ee7f13a4dcae4b20b728bd386f33f9e9cbf98e8347" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-index-fetch_multi_keyword_hot_trend" } }, "/apis/v1/tikhub/douyin/index/fetch_multi_keyword_interpretation": { "post": { "description": "Douyin (index).\n\n### Purpose\n- Get interpretation data for multiple keywords (composite index, search index, content index, etc.)\n- Recommended to use together with fetch_multi_keyword_hot_trend\n\n### Parameters\n- keyword_list: Comma separated keywords\n- start_date/end_date: Date range in YYYYMMDD\n- app_name: Platform, aweme=Douyin, toutiao=Toutiao\n- region: Region filter, comma separated, empty for all\n\n### Return\n- Keyword composite index, search index, content index interpretation\n\nAPI references: `fetch_multi_keyword_hot_trend` = `POST /tikhub/douyin/index/fetch_multi_keyword_hot_trend` (operationId: `post_tikhub_douyin_index_fetch_multi_keyword_hot_trend`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_index_fetch_multi_keyword_interpretation", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Keyword composite index, search index, content index interpretation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_multi_keyword_interpretation", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "df814ca4dbb3" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/index/fetch_multi_keyword_interpretation", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_index_fetch_multi_keyword_interpretation", "method": "POST", "path": "/apis/v1/tikhub/douyin/index/fetch_multi_keyword_interpretation" }, "parameters": [ { "name": "app_name", "in": "query", "required": false, "schema": { "enum": [ "aweme", "toutiao" ], "type": "string", "description": "Platform: aweme (Douyin), toutiao (Toutiao)", "default": "aweme", "title": "App Name" }, "description": "Platform: aweme (Douyin), toutiao (Toutiao)" }, { "name": "end_date", "in": "query", "required": true, "schema": { "type": "string", "description": "End date, YYYYMMDD", "title": "End Date" }, "description": "End date, YYYYMMDD" }, { "name": "keyword_list", "in": "query", "required": true, "schema": { "type": "string", "description": "Keyword list, comma separated", "title": "Keyword List" }, "description": "Keyword list, comma separated" }, { "name": "region", "in": "query", "required": false, "schema": { "type": "string", "description": "Region list, comma separated", "default": "", "title": "Region" }, "description": "Region list, comma separated" }, { "name": "start_date", "in": "query", "required": true, "schema": { "type": "string", "description": "Start date, YYYYMMDD", "title": "Start Date" }, "description": "Start date, YYYYMMDD" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:f54fd0ca73beebbeb2dacc086c0326c7a65def11af2bea6ab6b7e057d62cd49c" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-index-fetch_multi_keyword_interpretation" } }, "/apis/v1/tikhub/douyin/index/fetch_portrait": { "post": { "description": "Douyin (index).\n\n### Purpose\n- Get crowd portrait analysis for a keyword\n\n### Parameters\n- keyword: The keyword to analyze\n- start_date/end_date: Date range in YYYYMMDD\n- app_name: Platform, aweme=Douyin, toutiao=Toutiao\n\n### Return\n- Gender, age, region, interest distributions and other portrait data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_index_fetch_portrait", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Gender, age, region, interest distributions and other portrait data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_portrait", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "fc6fff3390ba" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/index/fetch_portrait", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_index_fetch_portrait", "method": "POST", "path": "/apis/v1/tikhub/douyin/index/fetch_portrait" }, "parameters": [ { "name": "app_name", "in": "query", "required": false, "schema": { "enum": [ "aweme", "toutiao" ], "type": "string", "description": "Platform: aweme (Douyin), toutiao (Toutiao)", "default": "aweme", "title": "App Name" }, "description": "Platform: aweme (Douyin), toutiao (Toutiao)" }, { "name": "end_date", "in": "query", "required": true, "schema": { "type": "string", "description": "End date YYYYMMDD", "title": "End Date" }, "description": "End date YYYYMMDD" }, { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Keyword", "title": "Keyword" }, "description": "Keyword" }, { "name": "start_date", "in": "query", "required": true, "schema": { "type": "string", "description": "Start date YYYYMMDD", "title": "Start Date" }, "description": "Start date YYYYMMDD" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:ef1bfbca4c70e952d06c312a7defe54ad480b9b69ed6da3c26af38f0d4016c3f" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-index-fetch_portrait" } }, "/apis/v1/tikhub/douyin/index/fetch_relation_word": { "post": { "description": "Douyin (index).\n\n### Purpose:\n- Get relation word analysis for a keyword, including search and content relation words\n- Shows relation word graph and ranking\n### Parameters:\n- keyword: The keyword to analyze\n- start_date: Start date (recommend Monday), format YYYYMMDD\n- end_date: End date (**must be a Sunday**), format YYYYMMDD\n- app_name: Platform, aweme=Douyin, toutiao=Toutiao\n### Note:\n- **The end_date must be a Sunday**, e.g. start_date=20260330, end_date=20260405 (Sunday)\n- If end_date is not a Sunday, the API may return empty data\n### Return:\n- Search relation words, content relation words, relation word graph data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_index_fetch_relation_word", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Search relation words, content relation words, relation word graph data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_relation_word", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "24ac0ef1d3aa" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/index/fetch_relation_word", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_index_fetch_relation_word", "method": "POST", "path": "/apis/v1/tikhub/douyin/index/fetch_relation_word" }, "parameters": [ { "name": "app_name", "in": "query", "required": false, "schema": { "enum": [ "aweme", "toutiao" ], "type": "string", "description": "Platform: aweme (Douyin), toutiao (Toutiao)", "default": "aweme", "title": "App Name" }, "description": "Platform: aweme (Douyin), toutiao (Toutiao)" }, { "name": "end_date", "in": "query", "required": true, "schema": { "type": "string", "description": "End date (must be Sunday) YYYYMMDD", "title": "End Date" }, "description": "End date (must be Sunday) YYYYMMDD" }, { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Keyword", "title": "Keyword" }, "description": "Keyword" }, { "name": "start_date", "in": "query", "required": true, "schema": { "type": "string", "description": "Start date (Monday) YYYYMMDD", "title": "Start Date" }, "description": "Start date (Monday) YYYYMMDD" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:f2e8daea05a310a059d195d3833e6e8e34857e117594ef6ffb2f3a174c0ae04b" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-index-fetch_relation_word" } }, "/apis/v1/tikhub/douyin/index/fetch_report_detail": { "get": { "description": "Douyin (index).\n\n### Purpose:\n- Get full detail of a trend insight report\n- Includes title, cover, publish time, business tags, content body, image assets,\n and PDF download links\n### Parameters:\n- report_id: Report ID (string), obtained from fetch_report_search or\n fetch_insight_recommend results\n### Return:\n- Full report data: title, cover, publish_time, business, content, images, pdf_url, etc.\n\nAPI references: `fetch_insight_recommend` = `GET /tikhub/douyin/index/fetch_insight_recommend` (operationId: `get_tikhub_douyin_index_fetch_insight_recommend`); `fetch_report_search` = `POST /tikhub/douyin/index/fetch_report_search` (operationId: `post_tikhub_douyin_index_fetch_report_search`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_index_fetch_report_detail", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Full report data: title, cover, publish_time, business, content, images, pdf_url, etc.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_report_detail", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "34219001a443" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/index/fetch_report_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_index_fetch_report_detail", "method": "GET", "path": "/apis/v1/tikhub/douyin/index/fetch_report_detail" }, "parameters": [ { "name": "report_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Report ID. Example: 1081\n\nUsage: Report ID (string), obtained from fetch_report_search or\n fetch_insight_recommend results\n\nAPI references: `fetch_insight_recommend` = `GET /tikhub/douyin/index/fetch_insight_recommend` (operationId: `get_tikhub_douyin_index_fetch_insight_recommend`); `fetch_report_search` = `POST /tikhub/douyin/index/fetch_report_search` (operationId: `post_tikhub_douyin_index_fetch_report_search`).", "title": "Report Id" }, "description": "Report ID. Example: 1081\n\nUsage: Report ID (string), obtained from fetch_report_search or\n fetch_insight_recommend results\n\nAPI references: `fetch_insight_recommend` = `GET /tikhub/douyin/index/fetch_insight_recommend` (operationId: `get_tikhub_douyin_index_fetch_insight_recommend`); `fetch_report_search` = `POST /tikhub/douyin/index/fetch_report_search` (operationId: `post_tikhub_douyin_index_fetch_report_search`)." } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:edc6dd4fa6f39338b0315b5749d9040b4e79feb28e5809885c0a364e3dc632e2" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-index-fetch_report_detail" } }, "/apis/v1/tikhub/douyin/index/fetch_report_search": { "post": { "description": "Douyin (index).\n\n### Purpose\n- Search trend insight reports under Douyin Index\n\n### Parameters\n- current_page / page_size: pagination (string)\n- type: report type, empty for all\n- business: comma-separated product list\n- report_time: comma-separated year list, e.g. \"2024,2023\"\n- search: keyword search\n- category: top-level category ID, default \"6\"\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_index_fetch_report_search", "responses": { "200": { "description": "Successful response. Returns reports with title, cover, publication time, product tags, and report ID.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_report_search", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a48f027062e4" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/index/fetch_report_search", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_index_fetch_report_search", "method": "POST", "path": "/apis/v1/tikhub/douyin/index/fetch_report_search" }, "parameters": [ { "name": "business", "in": "query", "required": false, "schema": { "type": "string", "description": "Business list, comma separated. Options: Juliang Engine, Toutiao, Douyin, Xigua Video, Douyin eCommerce, Shixiaolu, Other", "default": "", "title": "Business" }, "description": "Business list, comma separated. Options: Juliang Engine, Toutiao, Douyin, Xigua Video, Douyin eCommerce, Shixiaolu, Other" }, { "name": "category", "in": "query", "required": false, "schema": { "type": "string", "description": "Top category ID (default 6 = Douyin Index trend reports)", "default": "6", "title": "Category" }, "description": "Top category ID (default 6 = Douyin Index trend reports)" }, { "name": "current_page", "in": "query", "required": false, "schema": { "type": "string", "description": "Page number", "default": "1", "title": "Current Page" }, "description": "Page number" }, { "name": "page_size", "in": "query", "required": false, "schema": { "type": "string", "description": "Page size", "default": "16", "title": "Page Size" }, "description": "Page size" }, { "name": "report_time", "in": "query", "required": false, "schema": { "type": "string", "description": "Year list, comma separated. e.g. 2024,2023", "default": "", "title": "Report Time" }, "description": "Year list, comma separated. e.g. 2024,2023" }, { "name": "search", "in": "query", "required": false, "schema": { "type": "string", "description": "Search keyword", "default": "", "title": "Search" }, "description": "Search keyword" }, { "name": "type", "in": "query", "required": false, "schema": { "enum": [ "", "行业洞察", "产品洞察", "用户洞察", "趋势洞察" ], "type": "string", "description": "Report type. Use the literal enum values: empty=all, \"行业洞察\"=industry insights, \"产品洞察\"=product insights, \"用户洞察\"=user insights, \"趋势洞察\"=trend insights. The Chinese strings are required wire values.", "default": "", "title": "Type" }, "description": "Report type. Use the literal enum values: empty=all, \"行业洞察\"=industry insights, \"产品洞察\"=product insights, \"用户洞察\"=user insights, \"趋势洞察\"=trend insights. The Chinese strings are required wire values." } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:c252dc99c84f079b0248230f605ca9c073d23613c33447f4ed24801b52c38354" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-index-fetch_report_search" } }, "/apis/v1/tikhub/douyin/index/fetch_topic_query": { "post": { "description": "Douyin (index).\n\n### Purpose\n- Search topics, get topic details and related data\n\n### Parameters\n- keyword: Topic keyword\n- start_date/end_date: Date range in YYYYMMDD\n- app_name: Platform\n\n### Return\n- Topic details, topic popularity, related video count, etc.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_index_fetch_topic_query", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Topic details, topic popularity, related video count, etc.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_topic_query", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "cdfff1458869" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/index/fetch_topic_query", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_index_fetch_topic_query", "method": "POST", "path": "/apis/v1/tikhub/douyin/index/fetch_topic_query" }, "parameters": [ { "name": "app_name", "in": "query", "required": false, "schema": { "enum": [ "aweme", "toutiao" ], "type": "string", "description": "Platform: aweme (Douyin), toutiao (Toutiao)", "default": "aweme", "title": "App Name" }, "description": "Platform: aweme (Douyin), toutiao (Toutiao)" }, { "name": "end_date", "in": "query", "required": true, "schema": { "type": "string", "description": "End date YYYYMMDD", "title": "End Date" }, "description": "End date YYYYMMDD" }, { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Topic keyword", "title": "Keyword" }, "description": "Topic keyword" }, { "name": "start_date", "in": "query", "required": true, "schema": { "type": "string", "description": "Start date YYYYMMDD", "title": "Start Date" }, "description": "Start date YYYYMMDD" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:4e9da3887adb988104197e0d98739d964d97bf3581b08ae0874bf7f5300c788c" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-index-fetch_topic_query" } }, "/apis/v1/tikhub/douyin/index/fetch_topic_suggest": { "post": { "description": "Douyin (index).\n\n### Purpose:\n- Get topic search auto-complete suggestion list\n### Parameters:\n- keyword: Topic keyword\n- app_name: Platform, aweme=Douyin, toutiao=Toutiao\n### Return:\n- Matched topic list\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_index_fetch_topic_suggest", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Matched topic list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_topic_suggest", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "fe4b57eaae9c" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/index/fetch_topic_suggest", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_index_fetch_topic_suggest", "method": "POST", "path": "/apis/v1/tikhub/douyin/index/fetch_topic_suggest" }, "parameters": [ { "name": "app_name", "in": "query", "required": false, "schema": { "enum": [ "aweme", "toutiao" ], "type": "string", "description": "Platform: aweme (Douyin), toutiao (Toutiao)", "default": "aweme", "title": "App Name" }, "description": "Platform: aweme (Douyin), toutiao (Toutiao)" }, { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Topic keyword", "title": "Keyword" }, "description": "Topic keyword" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:10b5a62d31a30131e5e6fabd3eff787b300b7d084dfd9448a8ae88e7c46c98b4" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-index-fetch_topic_suggest" } }, "/apis/v1/tikhub/douyin/index/fetch_valid_date_for_relation": { "get": { "description": "Douyin (index).\n\n### Purpose:\n- Get valid date range for the relation analysis feature\n### Return:\n- Start and end available dates for relation analysis\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_index_fetch_valid_date_for_relation", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Start and end available dates for relation analysis", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_valid_date_for_relation", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "928f08b1fa84" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/index/fetch_valid_date_for_relation", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_index_fetch_valid_date_for_relation", "method": "GET", "path": "/apis/v1/tikhub/douyin/index/fetch_valid_date_for_relation" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:271e1480976f74cd0cd88fb1c65b2befc08e0af4940859c3a61fd40cbb7ce2ab" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-index-fetch_valid_date_for_relation" } }, "/apis/v1/tikhub/douyin/search/fetch_challenge_search_v2": { "post": { "description": "Douyin (search).\n\n### Purpose\n- Fetch hashtag/challenge search results from Douyin App using V2 API.\n- Supports searching by keyword and returns detailed challenge information, including name, cover image, view count, and participant count.\n\n### Notes\n- This API focuses on searching challenges (hashtags), not including videos or live streams.\n- Set `cursor` to 0 and `search_id` to an empty string for the first request. For pagination, use the cursor and search_id from the last response.\n\n### Parameters\n- keyword: Search keyword, e.g., \"game\"\n- cursor: Pagination cursor (0 for first request)\n- sort_type: Sorting method\n - `0`: Comprehensive\n - `1`: Most likes\n - `2`: Latest\n- publish_time: Publish time filter\n - `0`: Unlimited\n - `1`: Last day\n - `7`: Last week\n - `180`: Last half year\n- filter_duration: Video duration filter\n - `0`: Unlimited\n - `0-1`: Under 1 minute\n - `1-5`: 1-5 minutes\n - `5-10000`: Over 5 minutes\n- content_type: Content type filter\n - `0`: Unlimited\n - `1`: Video\n - `2`: Image\n - `3`: Article\n- search_id: Search ID for pagination\n\n### Request Body Example\n```json\npayload = {\n \"keyword\": \"game\",\n \"cursor\": 0,\n \"sort_type\": \"0\",\n \"publish_time\": \"0\",\n \"filter_duration\": \"0\",\n \"content_type\": \"0\",\n \"search_id\": \"\"\n}\n```\n\n### Response (common fields, actual response may contain more fields)\n- `business_data` (list of hashtag search results)\n - `data_id`: Unique identifier for the result\n - `type`: Data type (fixed `2`)\n - `data.challenge_info`:\n - `cid`: Challenge ID\n - `cha_name`: Challenge name\n - `desc`: Challenge description\n - `schema`: Challenge detail schema link (aweme:// schema, used to deep link inside Douyin App)\n - `hashtag_profile`: URL of the hashtag cover image\n - `user_count`: Number of participants\n - `view_count`: Number of views\n - `challenge_status`: Status (1 = active, others = abnormal)\n - `author`: Creator info\n - `uid`: User ID\n - `nickname`: Nickname\n - `avatar_thumb.url_list`: Thumbnail avatar URLs\n - `is_verified`: Whether the creator is verified\n - `follower_count`: Number of followers\n - `share_info`:\n - `share_url`: Shareable URL\n - `share_title`: Title for sharing\n - `share_desc`: Description for sharing\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_search_fetch_challenge_search_v2", "responses": { "200": { "description": "Successful Response\n\n### Response (common fields, actual response may contain more fields)\n- `business_data` (list of hashtag search results)\n - `data_id`: Unique identifier for the result\n - `type`: Data type (fixed `2`)\n - `data.challenge_info`:\n - `cid`: Challenge ID\n - `cha_name`: Challenge name\n - `desc`: Challenge description\n - `schema`: Challenge detail schema link (aweme:// schema, used to deep link inside Douyin App)\n - `hashtag_profile`: URL of the hashtag cover image\n - `user_count`: Number of participants\n - `view_count`: Number of views\n - `challenge_status`: Status (1 = active, others = abnormal)\n - `author`: Creator info\n - `uid`: User ID\n - `nickname`: Nickname\n - `avatar_thumb.url_list`: Thumbnail avatar URLs\n - `is_verified`: Whether the creator is verified\n - `follower_count`: Number of followers\n - `share_info`:\n - `share_url`: Shareable URL\n - `share_title`: Title for sharing\n - `share_desc`: Description for sharing", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_challenge_search", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "search", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "e879e3193536" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/search/fetch_challenge_search_v2", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_search_fetch_challenge_search_v2", "method": "POST", "path": "/apis/v1/tikhub/douyin/search/fetch_challenge_search_v2" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "keyword": { "type": "string", "title": "Keyword", "description": "Keyword", "default": "猫咪" }, "cursor": { "type": "integer", "title": "Cursor", "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)", "default": 0 }, "sort_type": { "type": "string", "title": "Sort Type", "description": "Sort type: 0=Comprehensive, 1=Most Likes, 2=Latest\n\nUsage: Sorting method\n - `0`: Comprehensive\n - `1`: Most likes\n - `2`: Latest", "default": "0" }, "publish_time": { "type": "string", "title": "Publish Time", "description": "Publish time filter: 0=Unlimited, 1=Last day, 7=Last week, 180=Last half year", "default": "0" }, "filter_duration": { "type": "string", "title": "Filter Duration", "description": "Video duration filter: 0=Unlimited, 0-1=Within 1 minute, 1-5=1 to 5 minutes, 5-10000=More than 5 minutes", "default": "0" }, "content_type": { "type": "string", "title": "Content Type", "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", "default": "0" }, "search_id": { "type": "string", "title": "Search Id", "description": "Search ID for pagination, obtained from the last response", "default": "" }, "backtrace": { "type": "string", "title": "Backtrace", "description": "Backtrace for pagination, obtained from the last response", "default": "" } }, "type": "object", "title": "ChallengeSearchV2Request" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:57c0594f2f6b50054fc684cb1fd220b82e2a3937ff304b58a3a7392e631726bf" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-search-fetch_challenge_search_v2" } }, "/apis/v1/tikhub/douyin/search/fetch_challenge_suggest": { "post": { "description": "Douyin (search).\n\n### Purpose\n- Fetch hashtag/challenge suggestions from Douyin App based on the input keyword.\n- Returns a list of related hashtags including name and view count.\n\n### Notes\n- Suitable for implementing keyword suggestion features in search bars.\n- Set `cursor` to 0 and `search_id` to an empty string for the first request.\n\n### Parameters\n- keyword: Search keyword, e.g., \"game\"\n\n### Request Body Example\n```json\npayload = {\n \"keyword\": \"game\"\n}\n```\n\n### Response (common fields, actual response may contain more fields)\n- `sug_list[]`: List of suggested hashtags\n - `cha_name`: Hashtag name (e.g., \"#game\")\n - `view_count`: Total view count\n - `cid`: Challenge ID\n - `group_id`: Associated group ID\n - `tag`: Tag category (0=normal, 1=hot trend)\n- `status_code`: Status code (0=success)\n- `status_msg`: Status message (usually empty)\n- `rid`: Request ID\n- `words_query_record`:\n - `info`: Additional info (currently empty)\n - `words_source`: Words source (\"sug\")\n - `query_id`: Query ID (usually empty)\n- `extra`:\n - `now`: Server timestamp\n - `logid`: Log ID\n - `fatal_item_ids`: List of fatal item IDs (usually empty)\n - `search_request_id`: Search request ID (usually empty)\n- `log_pb`:\n - `impr_id`: Impression ID (for logging)\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_search_fetch_challenge_suggest", "responses": { "200": { "description": "Successful Response\n\n### Response (common fields, actual response may contain more fields)\n- `sug_list[]`: List of suggested hashtags\n - `cha_name`: Hashtag name (e.g., \"#game\")\n - `view_count`: Total view count\n - `cid`: Challenge ID\n - `group_id`: Associated group ID\n - `tag`: Tag category (0=normal, 1=hot trend)\n- `status_code`: Status code (0=success)\n- `status_msg`: Status message (usually empty)\n- `rid`: Request ID\n- `words_query_record`:\n - `info`: Additional info (currently empty)\n - `words_source`: Words source (\"sug\")\n - `query_id`: Query ID (usually empty)\n- `extra`:\n - `now`: Server timestamp\n - `logid`: Log ID\n - `fatal_item_ids`: List of fatal item IDs (usually empty)\n - `search_request_id`: Search request ID (usually empty)\n- `log_pb`:\n - `impr_id`: Impression ID (for logging)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_challenge_suggest", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "search", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "ae585ea9f57d" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/search/fetch_challenge_suggest", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_search_fetch_challenge_suggest", "method": "POST", "path": "/apis/v1/tikhub/douyin/search/fetch_challenge_suggest" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "keyword": { "type": "string", "title": "Keyword", "description": "Keyword, e.g., 'game'", "default": "游戏" } }, "type": "object", "title": "ChallengeSuggestRequest" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:c82353fe28a7cc9c24219c732d33be69d6d8c933f84a8093afe46b74072ea55d" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-search-fetch_challenge_suggest" } }, "/apis/v1/tikhub/douyin/search/fetch_discuss_search": { "post": { "description": "Douyin (search).\n\n### Purpose\n- Fetch discussion/Q&A search results from Douyin App.\n- Supports filtering by keyword, sort type, publish time, content type, etc.\n\n### Notes\n- This API focuses on discussion and Q&A content, not including other content types.\n- Set `cursor` to 0 and `search_id` to an empty string for the first request.\n- The response includes video details, author info, playback info, statistics, hashtags, etc.\n\n### Parameters\n- keyword: Search keyword, e.g., \"study abroad\"\n- cursor: Pagination cursor (0 for first page, use the last response cursor for subsequent pages)\n- sort_type: Sorting method\n - `0`: Comprehensive\n - `1`: Most likes\n - `2`: Latest\n- publish_time: Publish time filter\n - `0`: Unlimited\n - `1`: Last day\n - `7`: Last week\n - `180`: Last half year\n- filter_duration: Video duration filter\n - `0`: Unlimited\n - `0-1`: Within 1 minute\n - `1-5`: 1 to 5 minutes\n - `5-10000`: More than 5 minutes\n- content_type: Content type filter\n - `0`: Unlimited\n - `1`: Video\n - `2`: Picture\n - `3`: Article\n- search_id: Search ID used for pagination\n\n### Request Body Example\n```json\npayload = {\n \"keyword\": \"study abroad\",\n \"cursor\": 0,\n \"sort_type\": \"0\",\n \"publish_time\": \"0\",\n \"filter_duration\": \"0\",\n \"content_type\": \"0\",\n \"search_id\": \"\"\n}\n```\n\n### Response (common fields, actual response may contain more fields)\n- `data`: List of search result items\n - `type`: Result type (usually `1`)\n - `aweme_info`: Video information\n - `aweme_id`: Video ID\n - `desc`: Description\n - `author`:\n - `uid`: User ID\n - `nickname`: User nickname\n - `is_verified`: Verified user or not\n - `region`: User region\n - `avatar_thumb.url_list`: Thumbnail avatar URLs\n - `avatar_medium.url_list`: Medium avatar URLs\n - `avatar_larger.url_list`: Large avatar URLs\n - `video`:\n - `play_addr.url_list`: Video playback URLs\n - `cover.url_list`: Video cover URLs\n - `dynamic_cover.url_list`: Dynamic cover URLs\n - `origin_cover.url_list`: Original cover URLs\n - `width`: Width in pixels\n - `height`: Height in pixels\n - `ratio`: Resolution ratio (e.g., 540p)\n - `duration`: Duration in milliseconds\n - `download_addr.url_list`: Download URLs with watermark\n - `statistics`:\n - `comment_count`: Number of comments\n - `digg_count`: Number of likes\n - `share_count`: Number of shares\n - `play_count`: Number of plays\n - `collect_count`: Number of collections\n - `cha_list`:\n - `cha_name`: Hashtag name\n - `share_url`: Hashtag share link\n - `music`:\n - `id_str`: Music ID\n - `title`: Music title\n - `author`: Music creator name\n - `play_url.url_list`: List of music playback URLs\n - `status`:\n - `is_delete`: Whether deleted\n - `is_private`: Whether private\n - `allow_share`: Allow sharing\n - `allow_comment`: Allow commenting\n - `share_url`: External video share link\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_search_fetch_discuss_search", "responses": { "200": { "description": "Successful Response\n\n### Response (common fields, actual response may contain more fields)\n- `data`: List of search result items\n - `type`: Result type (usually `1`)\n - `aweme_info`: Video information\n - `aweme_id`: Video ID\n - `desc`: Description\n - `author`:\n - `uid`: User ID\n - `nickname`: User nickname\n - `is_verified`: Verified user or not\n - `region`: User region\n - `avatar_thumb.url_list`: Thumbnail avatar URLs\n - `avatar_medium.url_list`: Medium avatar URLs\n - `avatar_larger.url_list`: Large avatar URLs\n - `video`:\n - `play_addr.url_list`: Video playback URLs\n - `cover.url_list`: Video cover URLs\n - `dynamic_cover.url_list`: Dynamic cover URLs\n - `origin_cover.url_list`: Original cover URLs\n - `width`: Width in pixels\n - `height`: Height in pixels\n - `ratio`: Resolution ratio (e.g., 540p)\n - `duration`: Duration in milliseconds\n - `download_addr.url_list`: Download URLs with watermark\n - `statistics`:\n - `comment_count`: Number of comments\n - `digg_count`: Number of likes\n - `share_count`: Number of shares\n - `play_count`: Number of plays\n - `collect_count`: Number of collections\n - `cha_list`:\n - `cha_name`: Hashtag name\n - `share_url`: Hashtag share link\n - `music`:\n - `id_str`: Music ID\n - `title`: Music title\n - `author`: Music creator name\n - `play_url.url_list`: List of music playback URLs\n - `status`:\n - `is_delete`: Whether deleted\n - `is_private`: Whether private\n - `allow_share`: Allow sharing\n - `allow_comment`: Allow commenting\n - `share_url`: External video share link", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_discuss_search", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "search", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "c1aec9e5250c" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/search/fetch_discuss_search", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_search_fetch_discuss_search", "method": "POST", "path": "/apis/v1/tikhub/douyin/search/fetch_discuss_search" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "keyword": { "type": "string", "title": "Keyword", "description": "Keyword", "default": "猫咪" }, "cursor": { "type": "integer", "title": "Cursor", "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)", "default": 0 }, "sort_type": { "type": "string", "title": "Sort Type", "description": "Sort type: 0=Comprehensive, 1=Most Likes, 2=Latest\n\nUsage: Sorting method\n - `0`: Comprehensive\n - `1`: Most likes\n - `2`: Latest", "default": "0" }, "publish_time": { "type": "string", "title": "Publish Time", "description": "Publish time filter: 0=Unlimited, 1=Last day, 7=Last week, 180=Last half year", "default": "0" }, "filter_duration": { "type": "string", "title": "Filter Duration", "description": "Video duration filter: 0=Unlimited, 0-1=Within 1 minute, 1-5=1 to 5 minutes, 5-10000=More than 5 minutes", "default": "0" }, "content_type": { "type": "string", "title": "Content Type", "description": "Content type: 0=All, 1=Video, 2=Picture, 3=Article\n\nUsage: Content type filter\n - `0`: Unlimited\n - `1`: Video\n - `2`: Picture\n - `3`: Article", "default": "0" }, "search_id": { "type": "string", "title": "Search Id", "description": "Search ID for pagination, obtained from the last response", "default": "" }, "backtrace": { "type": "string", "title": "Backtrace", "description": "Backtrace for pagination, obtained from the last response", "default": "" } }, "type": "object", "title": "DiscussSearchRequest" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:c0cf15ba32cd3eb296e94471a2e5293b7c48e8421fc65452591b5e2b832d10eb" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-search-fetch_discuss_search" } }, "/apis/v1/tikhub/douyin/search/fetch_experience_search": { "post": { "description": "Douyin (search).\n\n### Purpose\n- Fetch experience (knowledge/tutorial) content search results from Douyin App.\n- Retrieves video results related to knowledge sharing, tutorials, or tips based on the input keyword.\n\n### Notes\n- This API focuses on experience-related videos and does not include other content types.\n- Set `cursor` to 0 and `search_id` to an empty string for the first request; for pagination, use the previous cursor and search_id.\n- The response includes rich information such as video details, author profile, background music, hashtags, video URLs, and engagement statistics.\n\n### Parameters\n- keyword: Search keyword, e.g., \"gaming guide\"\n- cursor: Pagination cursor (0 for first page)\n- sort_type: Sorting method\n - `0`: Comprehensive\n - `1`: Most likes\n - `2`: Latest\n- publish_time: Publish time filter\n - `0`: Unlimited\n - `1`: Last day\n - `7`: Last week\n - `180`: Last half year\n- filter_duration: Video duration filter\n - `0`: Unlimited\n - `0-1`: Within 1 minute\n - `1-5`: 1 to 5 minutes\n - `5-10000`: More than 5 minutes\n- content_type: Content type filter (usually fixed to video)\n- search_id: Search ID for pagination\n\n### Request Body Example\n```json\npayload = {\n \"keyword\": \"gaming guide\",\n \"cursor\": 0,\n \"sort_type\": 0,\n \"publish_time\": 0,\n \"filter_duration\": 0,\n \"content_type\": 1,\n \"search_id\": \"\"\n}\n```\n\n### Response (common fields, actual response may contain more fields)\n- business_data: List of business data blocks\n - data_id: Data block ID\n - type: Data type (e.g., 999 for content list)\n - data:\n - height: Display height\n - aweme_list: List of videos\n - aweme_id: Video ID\n - desc: Video description\n - create_time: Creation timestamp\n - author: Author profile\n - uid: User ID\n - nickname: User nickname\n - avatar_thumb.url_list: Thumbnail avatar URLs\n - is_verified: Whether the author is verified\n - follower_count: Number of followers\n - music: Background music information\n - id_str: Music ID\n - title: Music title\n - author: Music author's name\n - cha_list: Associated hashtags\n - cha_name: Hashtag name\n - video: Video playback info\n - play_addr.url_list: List of video play URLs\n - cover.url_list: List of video cover image URLs\n - width: Video width\n - height: Video height\n - duration: Video duration in milliseconds\n - statistics: Video engagement data\n - digg_count: Number of likes\n - comment_count: Number of comments\n - share_count: Number of shares\n - play_count: Number of plays\n - status: Video status information\n - is_delete: Whether the video was deleted\n - is_private: Whether the video is private\n - share_url: External share link of the video\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_search_fetch_experience_search", "responses": { "200": { "description": "Successful Response\n\n### Response (common fields, actual response may contain more fields)\n- business_data: List of business data blocks\n - data_id: Data block ID\n - type: Data type (e.g., 999 for content list)\n - data:\n - height: Display height\n - aweme_list: List of videos\n - aweme_id: Video ID\n - desc: Video description\n - create_time: Creation timestamp\n - author: Author profile\n - uid: User ID\n - nickname: User nickname\n - avatar_thumb.url_list: Thumbnail avatar URLs\n - is_verified: Whether the author is verified\n - follower_count: Number of followers\n - music: Background music information\n - id_str: Music ID\n - title: Music title\n - author: Music author's name\n - cha_list: Associated hashtags\n - cha_name: Hashtag name\n - video: Video playback info\n - play_addr.url_list: List of video play URLs\n - cover.url_list: List of video cover image URLs\n - width: Video width\n - height: Video height\n - duration: Video duration in milliseconds\n - statistics: Video engagement data\n - digg_count: Number of likes\n - comment_count: Number of comments\n - share_count: Number of shares\n - play_count: Number of plays\n - status: Video status information\n - is_delete: Whether the video was deleted\n - is_private: Whether the video is private\n - share_url: External share link of the video", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_experience_search", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "search", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "2c75a4989f7b" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/search/fetch_experience_search", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_search_fetch_experience_search", "method": "POST", "path": "/apis/v1/tikhub/douyin/search/fetch_experience_search" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "keyword": { "type": "string", "title": "Keyword", "description": "Keyword", "default": "猫咪" }, "cursor": { "type": "integer", "title": "Cursor", "description": "Offset cursor for pagination, obtained from the last response\n\nUsage: Pagination cursor (0 for first page)", "default": 0 }, "sort_type": { "type": "string", "title": "Sort Type", "description": "Sort type: 0=Comprehensive, 1=Most Likes, 2=Latest\n\nUsage: Sorting method\n - `0`: Comprehensive\n - `1`: Most likes\n - `2`: Latest", "default": "0" }, "publish_time": { "type": "string", "title": "Publish Time", "description": "Publish time filter: 0=Unlimited, 1=Last day, 7=Last week, 180=Last half year", "default": "0" }, "filter_duration": { "type": "string", "title": "Filter Duration", "description": "Video duration filter: 0=Unlimited, 0-1=Within 1 minute, 1-5=1 to 5 minutes, 5-10000=More than 5 minutes", "default": "0" }, "content_type": { "type": "string", "title": "Content Type", "description": "Content type: 0=All, 1=Video, 2=Picture, 3=Article", "default": "0" }, "search_id": { "type": "string", "title": "Search Id", "description": "Search ID for pagination, obtained from the last response", "default": "" }, "backtrace": { "type": "string", "title": "Backtrace", "description": "Backtrace for pagination, obtained from the last response", "default": "" } }, "type": "object", "title": "ExperienceSearchRequest" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:a82bf9d1316e1c21c65972fbe8413527e1156c648fb460b698c0863c1bed0451" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-search-fetch_experience_search" } }, "/apis/v1/tikhub/douyin/search/fetch_general_search_v3": { "post": { "description": "Douyin (search).\n\n### Purpose\n- Fetch Douyin general search results (V3), returning mixed cards: videos, users, related words, etc.\n- Compared with V1/V2 it has no sorting or filtering options, but pagination is simpler and the\n response structure is unified (`config` + `items` + `pagination`).\n\n### Notes\n- For the first request set `offset` to 0, `page` to 1, and `search_id` / `backtrace` to empty strings.\n- For pagination, pass back `offset`, `search_id` and `backtrace` from `data.pagination` of the\n previous response, and increment `page` by 1.\n- `data.pagination.has_more` = 0 means the last page has been reached.\n- Page size is fixed at 10 and cannot be changed. `page` is capped at 200;\n exceeding it returns a parameter error.\n\n### Parameters\n- keyword: Search keyword, e.g., \"cat\"\n- offset: Offset cursor (0 for the first request)\n- page: Page number, 1-200 (1 for the first request)\n- search_id: Search ID (empty for the first request)\n- backtrace: Backtrace identifier (empty for the first request)\n\n### Request Body Example\n```json\npayload = {\n \"keyword\": \"cat\",\n \"offset\": 0,\n \"page\": 1,\n \"search_id\": \"\",\n \"backtrace\": \"\"\n}\n```\n\n### Response (common fields, actual response may contain more fields)\n- `config`: Search configuration returned by the upstream (passed through)\n- `items[]`: Result cards (already unwrapped by card type)\n - Video card:\n - `aweme_id`: Video ID\n - `desc`: Video description\n - `create_time`: Publish timestamp\n - `author`: Author info (`uid`, `sec_uid`, `nickname`, `avatar_thumb.url_list`, etc.)\n - `video`: Playback info (`play_addr.url_list`, `cover.url_list`, `duration`, etc.)\n - `statistics`: Interaction data (`digg_count`, `comment_count`, `share_count`, `play_count`)\n - `share_url`: External share link\n - Related-words card: list of suggested keywords\n - Unknown card types are passed through as-is\n- `pagination`: Pagination info\n - `offset`: Offset cursor for the next page (pass back as-is)\n - `cursor`: Same as `offset`\n - `search_id`: Search ID for the next page (pass back as-is)\n - `backtrace`: Backtrace for the next page (pass back as-is)\n - `has_more`: Whether more results are available (1=Yes, 0=No)\n - `next_page`: Next page number (`null` when there are no more results)\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_search_fetch_general_search_v3", "responses": { "200": { "description": "Successful Response\n\n### Response (common fields, actual response may contain more fields)\n- `config`: Search configuration returned by the upstream (passed through)\n- `items[]`: Result cards (already unwrapped by card type)\n - Video card:\n - `aweme_id`: Video ID\n - `desc`: Video description\n - `create_time`: Publish timestamp\n - `author`: Author info (`uid`, `sec_uid`, `nickname`, `avatar_thumb.url_list`, etc.)\n - `video`: Playback info (`play_addr.url_list`, `cover.url_list`, `duration`, etc.)\n - `statistics`: Interaction data (`digg_count`, `comment_count`, `share_count`, `play_count`)\n - `share_url`: External share link\n - Related-words card: list of suggested keywords\n - Unknown card types are passed through as-is\n- `pagination`: Pagination info\n - `offset`: Offset cursor for the next page (pass back as-is)\n - `cursor`: Same as `offset`\n - `search_id`: Search ID for the next page (pass back as-is)\n - `backtrace`: Backtrace for the next page (pass back as-is)\n - `has_more`: Whether more results are available (1=Yes, 0=No)\n - `next_page`: Next page number (`null` when there are no more results)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_general_search", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "search", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "4e1e6cdf267e" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/search/fetch_general_search_v3", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_search_fetch_general_search_v3", "method": "POST", "path": "/apis/v1/tikhub/douyin/search/fetch_general_search_v3" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "keyword": { "type": "string", "title": "Keyword", "description": "Search keyword", "default": "猫咪" }, "offset": { "type": "integer", "title": "Offset", "description": "Offset cursor for pagination, obtained from data.pagination.offset of the last response, 0 for the first request", "default": 0 }, "page": { "type": "integer", "title": "Page", "description": "Page number, 1-200, start with 1 and increment by 1 each time", "default": 1 }, "search_id": { "type": "string", "title": "Search Id", "description": "Search ID, obtained from data.pagination.search_id of the last response, empty for the first request", "default": "" }, "backtrace": { "type": "string", "title": "Backtrace", "description": "Backtrace, obtained from data.pagination.backtrace of the last response, empty for the first request", "default": "" } }, "type": "object", "title": "GeneralSearchV3Request" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:f90a97c641be2efb50531a603168f58fa65d7cd92456f06d219233f6e6377b45" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-search-fetch_general_search_v3" } }, "/apis/v1/tikhub/douyin/search/fetch_image_search_v3": { "post": { "description": "Douyin (search).\n\n### Purpose\n- Fetch image-text content search results from Douyin App.\n- Returns posts with multiple images (aweme_type=68), suitable for gallery-style applications.\n\n### Notes\n- This endpoint uses a different data source than `fetch_image_search`, results may vary.\n- Recommended for scenarios requiring high-quality image-text content.\n- For the first request, set `cursor` to 0 and `search_id` to an empty string.\n- For pagination, use the `cursor` and `search_id` from the last response.\n- Returns approximately 12 items per page.\n\n### Parameters\n- keyword: Search keyword, e.g., \"food\"\n- cursor: Pagination cursor (0 for first request)\n- search_id: Search ID for pagination (use value from previous response)\n\n### Request Body Example\n```json\npayload = {\n \"keyword\": \"food\",\n \"cursor\": 0,\n \"search_id\": \"\"\n}\n```\n\n### Response (common fields, actual response may contain more fields)\n- `status_code`: Status code (0=success)\n- `business_data[]`: Image-text content list\n - `data`:\n - `aweme_list[]`: Content list\n - `aweme_id`: Content ID\n - `aweme_type`: Content type (68=image-text)\n - `desc`: Post description\n - `create_time`: Creation timestamp\n - `author`:\n - `uid`: Author ID\n - `nickname`: Nickname\n - `avatar_thumb.url_list`: Thumbnail avatar URLs\n - `image_post_info`:\n - `images[]`: Image list\n - `url_list`: Image URLs array\n - `width`: Width (pixels)\n - `height`: Height (pixels)\n - `statistics`:\n - `comment_count`: Comment count\n - `digg_count`: Like count\n - `share_count`: Share count\n - `collect_count`: Collect count\n - `share_url`: Shareable external link\n- `extra`:\n - `now`: Current server timestamp\n - `logid`: Request log ID\n\nUpstream-only reference: `fetch_image_search` is `POST /api/v1/douyin/search/fetch_image_search` in the official API. It is not exposed as an operation in this specification.\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_search_fetch_image_search_v3", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Response (common fields, actual response may contain more fields)\n- `status_code`: Status code (0=success)\n- `business_data[]`: Image-text content list\n - `data`:\n - `aweme_list[]`: Content list\n - `aweme_id`: Content ID\n - `aweme_type`: Content type (68=image-text)\n - `desc`: Post description\n - `create_time`: Creation timestamp\n - `author`:\n - `uid`: Author ID\n - `nickname`: Nickname\n - `avatar_thumb.url_list`: Thumbnail avatar URLs\n - `image_post_info`:\n - `images[]`: Image list\n - `url_list`: Image URLs array\n - `width`: Width (pixels)\n - `height`: Height (pixels)\n - `statistics`:\n - `comment_count`: Comment count\n - `digg_count`: Like count\n - `share_count`: Share count\n - `collect_count`: Collect count\n - `share_url`: Shareable external link\n- `extra`:\n - `now`: Current server timestamp\n - `logid`: Request log ID", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_image_search", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "search", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "737f7002521c" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/search/fetch_image_search_v3", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_search_fetch_image_search_v3", "method": "POST", "path": "/apis/v1/tikhub/douyin/search/fetch_image_search_v3" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "keyword": { "type": "string", "title": "Keyword", "description": "Search keyword" }, "cursor": { "type": "integer", "title": "Cursor", "description": "Pagination cursor (0 for the first request)", "default": 0 }, "search_id": { "type": "string", "title": "Search Id", "description": "Search ID for pagination", "default": "" } }, "type": "object", "required": [ "keyword" ], "title": "ImageSearchV3Request" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:93d7dc083582c49f780945fcdd2553aea12a10a921bd58e255f6be035e3a574b" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-search-fetch_image_search_v3" } }, "/apis/v1/tikhub/douyin/search/fetch_live_search_v2": { "post": { "description": "Douyin (search).\n\n### Purpose\n- Search live rooms by Douyin ID or nickname (V2), with cursor pagination.\n- Best suited for locating a specific streamer's live room rather than searching live\n content by topic keyword.\n\n### Notes\n- `keyword` matches the streamer's Douyin ID or nickname; a content keyword (e.g., \"games\")\n usually returns no result.\n- This endpoint has no sorting, publish time or duration filters.\n- Page size is fixed at 10 and cannot be changed.\n- Set `cursor` to 0 for the first request, then pass the `cursor` from the previous response.\n\n### Parameters\n- keyword: Douyin ID or nickname (required), e.g., \"Little Ears\"\n- cursor: Pagination cursor (0 for the first request)\n\n### Request Body Example\n```json\npayload = {\n \"keyword\": \"Little Ears\",\n \"cursor\": 0\n}\n```\n\n### Response (common fields, actual response may contain more fields)\n- Matched live room list; each item contains the streamer's nickname, Douyin ID, avatar,\n room ID and live status\n- Pagination info (next `cursor`, whether more results are available)\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_search_fetch_live_search_v2", "responses": { "200": { "description": "Successful Response\n\n### Response (common fields, actual response may contain more fields)\n- Matched live room list; each item contains the streamer's nickname, Douyin ID, avatar,\n room ID and live status\n- Pagination info (next `cursor`, whether more results are available)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_live_search", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "search", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "45c7a788e182" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/search/fetch_live_search_v2", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_search_fetch_live_search_v2", "method": "POST", "path": "/apis/v1/tikhub/douyin/search/fetch_live_search_v2" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "keyword": { "type": "string", "title": "Keyword", "description": "Douyin ID or nickname", "default": "小耳朵" }, "cursor": { "type": "integer", "title": "Cursor", "description": "Pagination cursor, 0 for the first request, then the cursor from the last response", "default": 0 } }, "type": "object", "title": "LiveSearchV2Request" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:21ca8fafb92a047568f9212c111660fe9bbeb7a56071c67f2f50ee66cff5f0c4" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-search-fetch_live_search_v2" } }, "/apis/v1/tikhub/douyin/search/fetch_multi_search": { "post": { "description": "Douyin (search).\n\n### Purpose\n- Fetch multiple types of search results (videos, users, music, hashtags, etc.) from Douyin App.\n\n### Notes\n- Set `cursor` to 0 and `search_id` to an empty string for the first request.\n- Suitable for search aggregation pages, discovery modules, and recommendations.\n\n### Parameters\n- keyword: Search keyword, e.g., \"Artificial Intelligence\"\n- cursor: Pagination cursor (0 for the first page, use the last response cursor for subsequent pages)\n- sort_type: Sorting method\n - `0`: Comprehensive\n - `1`: Most likes\n - `2`: Latest\n- publish_time: Publish time filter\n - `0`: Unlimited\n - `1`: Last day\n - `7`: Last week\n - `180`: Last half year\n- filter_duration: Video duration filter\n - `0`: Unlimited\n - `0-1`: Within 1 minute\n - `1-5`: 1 to 5 minutes\n - `5-10000`: More than 5 minutes\n- content_type: Content type filter\n - `0`: Unlimited\n - `1`: Video\n - `2`: Picture\n - `3`: Article\n- search_id: Search ID used for pagination\n\n### Request Body Example\n```json\npayload = {\n \"keyword\": \"Artificial Intelligence\",\n \"cursor\": 0,\n \"sort_type\": \"0\",\n \"publish_time\": \"0\",\n \"filter_duration\": \"0\",\n \"content_type\": \"0\",\n \"search_id\": \"\"\n}\n```\n\n### Response (common fields, actual response may contain more fields)\n- `cursor`: Cursor for the next page\n- `has_more`: Whether there are more results (1=Yes, 0=No)\n- `business_data[]`: List of search result items\n - `data_id`: Data ID\n - `type`: Result type\n - `1`: Video (aweme_info)\n - `2`: User (user_info)\n - `4`: Music (music_info)\n - `6`: Hashtag (cha_info)\n - `data`: Content depending on `type`\n - if type = 1 (video):\n - `aweme_info`: Detailed video info\n - if type = 2 (user):\n - `user_info`: Detailed user info\n - if type = 4 (music):\n - `music_info`: Music details\n - if type = 6 (hashtag):\n - `cha_info`: Hashtag details\n\n- `extra`:\n - `now`: Current server timestamp\n - `logid`: Request log ID\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_search_fetch_multi_search", "responses": { "200": { "description": "Successful Response\n\n### Response (common fields, actual response may contain more fields)\n- `cursor`: Cursor for the next page\n- `has_more`: Whether there are more results (1=Yes, 0=No)\n- `business_data[]`: List of search result items\n - `data_id`: Data ID\n - `type`: Result type\n - `1`: Video (aweme_info)\n - `2`: User (user_info)\n - `4`: Music (music_info)\n - `6`: Hashtag (cha_info)\n - `data`: Content depending on `type`\n - if type = 1 (video):\n - `aweme_info`: Detailed video info\n - if type = 2 (user):\n - `user_info`: Detailed user info\n - if type = 4 (music):\n - `music_info`: Music details\n - if type = 6 (hashtag):\n - `cha_info`: Hashtag details\n\n- `extra`:\n - `now`: Current server timestamp\n - `logid`: Request log ID", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_multi_search", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "search", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "8b01e0b3e17d" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/search/fetch_multi_search", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_search_fetch_multi_search", "method": "POST", "path": "/apis/v1/tikhub/douyin/search/fetch_multi_search" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "keyword": { "type": "string", "title": "Keyword", "description": "Keyword", "default": "猫咪" }, "cursor": { "type": "integer", "title": "Cursor", "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)", "default": 0 }, "sort_type": { "type": "string", "title": "Sort Type", "description": "Sort type: 0=Comprehensive, 1=Most Likes, 2=Latest\n\nUsage: Sorting method\n - `0`: Comprehensive\n - `1`: Most likes\n - `2`: Latest", "default": "0" }, "publish_time": { "type": "string", "title": "Publish Time", "description": "Publish time filter: 0=Unlimited, 1=Last day, 7=Last week, 180=Last half year", "default": "0" }, "filter_duration": { "type": "string", "title": "Filter Duration", "description": "Video duration filter: 0=Unlimited, 0-1=Within 1 minute, 1-5=1 to 5 minutes, 5-10000=More than 5 minutes", "default": "0" }, "content_type": { "type": "string", "title": "Content Type", "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", "default": "0" }, "search_id": { "type": "string", "title": "Search Id", "description": "Search ID for pagination, obtained from the last response", "default": "" }, "backtrace": { "type": "string", "title": "Backtrace", "description": "Backtrace for pagination, obtained from the last response", "default": "" } }, "type": "object", "title": "MultiSearchRequest" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:0170769a7a4c1d10d35ef8916a69f26b6c58cc8983a43bda06d18a1f0db3da1e" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-search-fetch_multi_search" } }, "/apis/v1/tikhub/douyin/search/fetch_music_search": { "post": { "description": "Douyin (search).\n\n### Purpose\n- Fetch music content search results from Douyin App.\n- Supports filtering by keyword, sort type, etc.\n\n### Notes\n- This API focuses on music content search, excluding other types.\n- Set `cursor` to 0 and `search_id` to an empty string for the first request.\n- Response includes music basic info, artist info, covers, play URLs, tags, etc.\n\n### Parameters\n- keyword: Search keyword, e.g., \"game background music\"\n- cursor: Pagination cursor (0 for first request)\n- sort_type: Sorting method\n - `0`: Comprehensive\n - `1`: Most likes\n - `2`: Latest\n- publish_time: Publish time filter\n - `0`: Unlimited\n - `1`: Last day\n - `7`: Last week\n - `180`: Last half year\n- filter_duration: Video duration filter\n - `0`: Unlimited\n - `0-1`: Under 1 minute\n - `1-5`: 1 to 5 minutes\n - `5-10000`: Over 5 minutes\n- content_type: Content type filter\n - `0`: Unlimited\n - `1`: Video\n - `2`: Image\n - `3`: Article\n- search_id: Search ID for pagination\n\n### Request Body Example\n```json\npayload = {\n \"keyword\": \"game background music\",\n \"cursor\": 0,\n \"sort_type\": \"0\",\n \"publish_time\": \"0\",\n \"filter_duration\": \"0\",\n \"content_type\": \"0\",\n \"search_id\": \"\"\n}\n```\n\n### Response (common fields, actual response may contain more fields)\n- `music`: List of music search results\n - `id_str`: Music ID (as string)\n - `title`: Music title\n - `author`: Music author's nickname\n - `album`: Album name (if any)\n - `play_url.url_list`: List of music play URLs\n - `duration`: Duration in seconds\n - `cover_thumb.url_list`: List of thumbnail cover URLs\n - `cover_medium.url_list`: List of medium-sized cover URLs\n - `cover_large.url_list`: List of large-sized cover URLs\n - `user_count`: Number of videos using this music\n - `is_original`: Whether it is original music\n - `is_commerce_music`: Whether it is commercial music\n - `lyric_url`: Lyrics file URL (if available)\n - `strong_beat_url.url_list`: Beat timing file URLs\n - `tags`: Music tags\n - Themes (e.g., Game, Vlog), Moods (e.g., Funny), Genres (e.g., 8-bit, Electronic)\n - `artists`: List of associated artists (if any)\n - `artist_name`: Artist name\n - `uid`: Artist UID\n - `cover_color_hsv`: Dominant HSV color of the cover\n - `can_background_play`: Whether background playback is supported\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_search_fetch_music_search", "responses": { "200": { "description": "Successful Response\n\n### Response (common fields, actual response may contain more fields)\n- `music`: List of music search results\n - `id_str`: Music ID (as string)\n - `title`: Music title\n - `author`: Music author's nickname\n - `album`: Album name (if any)\n - `play_url.url_list`: List of music play URLs\n - `duration`: Duration in seconds\n - `cover_thumb.url_list`: List of thumbnail cover URLs\n - `cover_medium.url_list`: List of medium-sized cover URLs\n - `cover_large.url_list`: List of large-sized cover URLs\n - `user_count`: Number of videos using this music\n - `is_original`: Whether it is original music\n - `is_commerce_music`: Whether it is commercial music\n - `lyric_url`: Lyrics file URL (if available)\n - `strong_beat_url.url_list`: Beat timing file URLs\n - `tags`: Music tags\n - Themes (e.g., Game, Vlog), Moods (e.g., Funny), Genres (e.g., 8-bit, Electronic)\n - `artists`: List of associated artists (if any)\n - `artist_name`: Artist name\n - `uid`: Artist UID\n - `cover_color_hsv`: Dominant HSV color of the cover\n - `can_background_play`: Whether background playback is supported", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_music_search", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "search", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "e0c79dbef588" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/search/fetch_music_search", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_search_fetch_music_search", "method": "POST", "path": "/apis/v1/tikhub/douyin/search/fetch_music_search" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "keyword": { "type": "string", "title": "Keyword", "description": "Keyword", "default": "猫咪" }, "cursor": { "type": "integer", "title": "Cursor", "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)", "default": 0 }, "sort_type": { "type": "string", "title": "Sort Type", "description": "Sort type: 0=Comprehensive, 1=Most Likes, 2=Latest\n\nUsage: Sorting method\n - `0`: Comprehensive\n - `1`: Most likes\n - `2`: Latest", "default": "0" }, "publish_time": { "type": "string", "title": "Publish Time", "description": "Publish time filter: 0=Unlimited, 1=Last day, 7=Last week, 180=Last half year", "default": "0" }, "filter_duration": { "type": "string", "title": "Filter Duration", "description": "Video duration filter: 0=Unlimited, 0-1=Within 1 minute, 1-5=1 to 5 minutes, 5-10000=More than 5 minutes", "default": "0" }, "content_type": { "type": "string", "title": "Content Type", "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", "default": "0" }, "search_id": { "type": "string", "title": "Search Id", "description": "Search ID for pagination, obtained from the last response", "default": "" }, "backtrace": { "type": "string", "title": "Backtrace", "description": "Backtrace for pagination, obtained from the last response", "default": "" } }, "type": "object", "title": "MusicSearchRequest" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:6aad38908b2e507602e799da9ebd9f267027a236cf2d2e2da0d917e2174dd42f" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-search-fetch_music_search" } }, "/apis/v1/tikhub/douyin/search/fetch_school_search": { "post": { "description": "Douyin (search).\n\n### Purpose\n- Fetch school information search results from Douyin App.\n- Returns a list of school names based on the input keyword, useful for user profile settings, school recommendations, etc.\n\n### Notes\n- This API focuses on school information search, and only returns school names.\n- Set `cursor` to 0 for the first request; for pagination, use the cursor from the last response.\n- The response structure is simple and lightweight for fast lookup.\n\n### Parameters\n- keyword: Search keyword, e.g., school name \"Peking University\" or city \"Beijing\"\n\n### Example Request Body\n```json\npayload = {\n \"keyword\": \"Peking University\"\n}\n```\n\n### Response (common fields, actual response may contain more fields)\n- `schools[]`: List of schools\n - `name`: School name (e.g., \"Peking University\", \"Beijing No.4 High School\")\n- `extra`:\n - `now`: Server timestamp in milliseconds\n - `logid`: Log ID for request tracing\n - `fatal_item_ids`: List of fatal item IDs (usually empty)\n- `log_pb`:\n - `impr_id`: Impression ID for tracking\n- `status_code`: Status code (0=success)\n- `status_msg`: Status message (usually empty)\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_search_fetch_school_search", "responses": { "200": { "description": "Successful Response\n\n### Response (common fields, actual response may contain more fields)\n- `schools[]`: List of schools\n - `name`: School name (e.g., \"Peking University\", \"Beijing No.4 High School\")\n- `extra`:\n - `now`: Server timestamp in milliseconds\n - `logid`: Log ID for request tracing\n - `fatal_item_ids`: List of fatal item IDs (usually empty)\n- `log_pb`:\n - `impr_id`: Impression ID for tracking\n- `status_code`: Status code (0=success)\n- `status_msg`: Status message (usually empty)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_school_search", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "search", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "844adcb6476f" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/search/fetch_school_search", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_search_fetch_school_search", "method": "POST", "path": "/apis/v1/tikhub/douyin/search/fetch_school_search" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "keyword": { "type": "string", "title": "Keyword", "description": "Keyword, such as school name or location", "default": "北京" } }, "type": "object", "title": "SchoolSearchRequest" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:18d52171c0984c70f969a24ab940b559140b64d5fd739e251c889ffb5029a949" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-search-fetch_school_search" } }, "/apis/v1/tikhub/douyin/search/fetch_search_suggest": { "post": { "description": "Douyin (search).\n\n### Purpose\n- Fetch keyword suggestion results from Douyin App.\n- Based on the user's input, returns a list of recommended search keywords to improve search experience.\n\n### Notes\n- Typically used for real-time keyword suggestions in the search box.\n- The returned suggestions are scored and sorted internally by Douyin's recommendation system.\n\n### Parameters\n- keyword: Input keyword, e.g., \"Artificial Intelligence\"\n\n### Request Body Example\n```json\npayload = {\n \"keyword\": \"Artificial Intelligence\"\n}\n```\n\n### Response (common fields, actual response may contain more fields)\n- `status_code`: Status code (0 means success)\n- `status_msg`: Response message (usually empty)\n- `rid`: Request ID\n- `sug_list[]`: List of suggested search keywords\n - `content`: Suggested keyword (e.g., \"AI software free download\")\n - `sug_type`: Suggestion type (usually empty, reserved field)\n - `pos[]`: Position marking\n - `begin`: Begin character position\n - `end`: End character position\n - `word_record`:\n - `group_id`: Suggestion group ID\n - `words_position`: Position in the current suggestion list\n - `words_content`: The word content (same as `content`)\n - `words_source`: Word source (typically \"sug\")\n - `extra_info`:\n - `client_server_extra`: Extra client-server config (JSON string)\n - `poi_id`: Related POI ID (usually empty)\n - `search_params`: Search parameters (with recommendation scores)\n- `words_query_record`:\n - `info`: Additional info (usually empty)\n - `words_source`: Source of suggestions\n - `query_id`: Suggestion query ID\n- `extra`:\n - `now`: Current server timestamp (milliseconds)\n - `logid`: Log ID\n - `fatal_item_ids`: List of fatal error items (usually empty)\n - `search_request_id`: Search request ID (usually empty)\n- `log_pb`:\n - `impr_id`: Impression log ID\n- `time_cost`:\n - `stream_inner`: Internal stream processing time (milliseconds)\n - `server_engine_cost`: Server search engine processing time (milliseconds)\n- `cache_conf`:\n - `enable`: Whether cache was hit (boolean)\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_search_fetch_search_suggest", "responses": { "200": { "description": "Successful Response\n\n### Response (common fields, actual response may contain more fields)\n- `status_code`: Status code (0 means success)\n- `status_msg`: Response message (usually empty)\n- `rid`: Request ID\n- `sug_list[]`: List of suggested search keywords\n - `content`: Suggested keyword (e.g., \"AI software free download\")\n - `sug_type`: Suggestion type (usually empty, reserved field)\n - `pos[]`: Position marking\n - `begin`: Begin character position\n - `end`: End character position\n - `word_record`:\n - `group_id`: Suggestion group ID\n - `words_position`: Position in the current suggestion list\n - `words_content`: The word content (same as `content`)\n - `words_source`: Word source (typically \"sug\")\n - `extra_info`:\n - `client_server_extra`: Extra client-server config (JSON string)\n - `poi_id`: Related POI ID (usually empty)\n - `search_params`: Search parameters (with recommendation scores)\n- `words_query_record`:\n - `info`: Additional info (usually empty)\n - `words_source`: Source of suggestions\n - `query_id`: Suggestion query ID\n- `extra`:\n - `now`: Current server timestamp (milliseconds)\n - `logid`: Log ID\n - `fatal_item_ids`: List of fatal error items (usually empty)\n - `search_request_id`: Search request ID (usually empty)\n- `log_pb`:\n - `impr_id`: Impression log ID\n- `time_cost`:\n - `stream_inner`: Internal stream processing time (milliseconds)\n - `server_engine_cost`: Server search engine processing time (milliseconds)\n- `cache_conf`:\n - `enable`: Whether cache was hit (boolean)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_search_suggest", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "search", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "79614a2231cb" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/search/fetch_search_suggest", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_search_fetch_search_suggest", "method": "POST", "path": "/apis/v1/tikhub/douyin/search/fetch_search_suggest" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "keyword": { "type": "string", "title": "Keyword", "description": "The keyword to be suggested", "default": "人工智能" } }, "type": "object", "title": "SearchSuggestRequest" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:39de33a80375ef5383a0e02f0a652f8f0dc0ff7837758b876fa80f661b33ecc6" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-search-fetch_search_suggest" } }, "/apis/v1/tikhub/douyin/search/fetch_user_search_v2": { "post": { "description": "Douyin (search).\n\n### Purpose\n- Fetch a list of users from Douyin App based on search keywords.\n- Supports filtering by fan count and user type.\n\n### Notes\n- Set `cursor` to 0.\n- Only user information is returned. No videos, music, or hashtags.\n\n### Parameters\n- keyword: Search keyword, e.g., \"AI\"\n- cursor: Pagination cursor (0 for first page)\n\n### Request Body Example\n```json\npayload = {\n \"keyword\": \"AI\",\n \"cursor\": 0\n}\n```\n\n### Response (common fields, actual response may contain more fields)\n- `cursor`: Cursor for next page\n- `has_more`: Whether more data is available (1=Yes, 0=No)\n- `user_list[]`: List of users\n - `user_info`:\n - `uid`: User ID\n - `nickname`: Nickname\n - `gender`: Gender (0=Unknown, 1=Male, 2=Female)\n - `unique_id`: Douyin ID\n - `sec_uid`: Secured UID\n - `signature`: Personal bio\n - `follower_count`: Number of followers\n - `avatar_thumb.url_list`: List of thumbnail avatar URLs\n - `avatar_medium.url_list`: List of medium avatar URLs\n - `avatar_larger.url_list`: List of large avatar URLs\n - `follow_status`: Whether followed\n - `live_status`: Whether live\n - `enterprise_verify_reason`: Enterprise verification info (if any)\n - `versatile_display`: Display text (e.g., \"Douyin ID: xxx\")\n- `extra`:\n - `now`: Current server timestamp\n - `logid`: Request log ID\n - `search_request_id`: Search request ID\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_search_fetch_user_search_v2", "responses": { "200": { "description": "Successful Response\n\n### Response (common fields, actual response may contain more fields)\n- `cursor`: Cursor for next page\n- `has_more`: Whether more data is available (1=Yes, 0=No)\n- `user_list[]`: List of users\n - `user_info`:\n - `uid`: User ID\n - `nickname`: Nickname\n - `gender`: Gender (0=Unknown, 1=Male, 2=Female)\n - `unique_id`: Douyin ID\n - `sec_uid`: Secured UID\n - `signature`: Personal bio\n - `follower_count`: Number of followers\n - `avatar_thumb.url_list`: List of thumbnail avatar URLs\n - `avatar_medium.url_list`: List of medium avatar URLs\n - `avatar_larger.url_list`: List of large avatar URLs\n - `follow_status`: Whether followed\n - `live_status`: Whether live\n - `enterprise_verify_reason`: Enterprise verification info (if any)\n - `versatile_display`: Display text (e.g., \"Douyin ID: xxx\")\n- `extra`:\n - `now`: Current server timestamp\n - `logid`: Request log ID\n - `search_request_id`: Search request ID", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_user_search", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "search", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "636d89592246" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/search/fetch_user_search_v2", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_search_fetch_user_search_v2", "method": "POST", "path": "/apis/v1/tikhub/douyin/search/fetch_user_search_v2" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "keyword": { "type": "string", "title": "Keyword", "description": "Keyword", "default": "猫咪" }, "cursor": { "type": "integer", "title": "Cursor", "description": "Offset cursor for pagination, obtained from the last response", "default": 0 } }, "type": "object", "title": "UserSearchRequestV2" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:d86ef64391fbd9ef201bc6197ee7b9ffc16f7e4622d8b97257a0cbf981930756" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-search-fetch_user_search_v2" } }, "/apis/v1/tikhub/douyin/search/fetch_video_search_v5": { "post": { "description": "Douyin (search).\n\n### Purpose\n- Search videos by keyword (V5), returning video content only.\n- Pagination parameters match general search V3, and the response structure is unified\n (`config` + `items` + `pagination`).\n\n### Notes\n- For the first request set `offset` to 0, `page` to 1, and `search_id` / `backtrace` to empty strings.\n- For pagination, pass back `offset`, `search_id` and `backtrace` from `data.pagination` of the\n previous response, and increment `page` by 1.\n- `data.pagination.has_more` = 0 means the last page has been reached.\n- Page size is fixed at 10 and cannot be changed. `page` is capped at 200;\n exceeding it returns a parameter error.\n\n### Parameters\n- keyword: Search keyword, e.g., \"cat\"\n- offset: Offset cursor (0 for the first request)\n- page: Page number, 1-200 (1 for the first request)\n- search_id: Search ID (empty for the first request)\n- backtrace: Backtrace identifier (empty for the first request)\n\n### Request Body Example\n```json\npayload = {\n \"keyword\": \"cat\",\n \"offset\": 0,\n \"page\": 1,\n \"search_id\": \"\",\n \"backtrace\": \"\"\n}\n```\n\n### Response (common fields, actual response may contain more fields)\n- `config`: Search configuration returned by the upstream (passed through)\n- `items[]`: Video list (already unwrapped by card type)\n - `aweme_id`: Video ID\n - `desc`: Video description\n - `create_time`: Publish timestamp\n - `author`: Author info (`uid`, `sec_uid`, `nickname`, `avatar_thumb.url_list`, etc.)\n - `video`: Playback info (`play_addr.url_list`, `cover.url_list`, `duration`, etc.)\n - `statistics`: Interaction data (`digg_count`, `comment_count`, `share_count`, `play_count`)\n - `share_url`: External share link\n- `pagination`: Pagination info\n - `offset`: Offset cursor for the next page (pass back as-is)\n - `cursor`: Same as `offset`\n - `search_id`: Search ID for the next page (pass back as-is)\n - `backtrace`: Backtrace for the next page (pass back as-is)\n - `has_more`: Whether more results are available (1=Yes, 0=No)\n - `next_page`: Next page number (`null` when there are no more results)\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_search_fetch_video_search_v5", "responses": { "200": { "description": "Successful Response\n\n### Response (common fields, actual response may contain more fields)\n- `config`: Search configuration returned by the upstream (passed through)\n- `items[]`: Video list (already unwrapped by card type)\n - `aweme_id`: Video ID\n - `desc`: Video description\n - `create_time`: Publish timestamp\n - `author`: Author info (`uid`, `sec_uid`, `nickname`, `avatar_thumb.url_list`, etc.)\n - `video`: Playback info (`play_addr.url_list`, `cover.url_list`, `duration`, etc.)\n - `statistics`: Interaction data (`digg_count`, `comment_count`, `share_count`, `play_count`)\n - `share_url`: External share link\n- `pagination`: Pagination info\n - `offset`: Offset cursor for the next page (pass back as-is)\n - `cursor`: Same as `offset`\n - `search_id`: Search ID for the next page (pass back as-is)\n - `backtrace`: Backtrace for the next page (pass back as-is)\n - `has_more`: Whether more results are available (1=Yes, 0=No)\n - `next_page`: Next page number (`null` when there are no more results)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_video_search", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "search", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "b036ec15b130" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/search/fetch_video_search_v5", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_search_fetch_video_search_v5", "method": "POST", "path": "/apis/v1/tikhub/douyin/search/fetch_video_search_v5" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "keyword": { "type": "string", "title": "Keyword", "description": "Search keyword", "default": "猫咪" }, "offset": { "type": "integer", "title": "Offset", "description": "Offset cursor for pagination, obtained from data.pagination.offset of the last response, 0 for the first request", "default": 0 }, "page": { "type": "integer", "title": "Page", "description": "Page number, 1-200, start with 1 and increment by 1 each time", "default": 1 }, "search_id": { "type": "string", "title": "Search Id", "description": "Search ID, obtained from data.pagination.search_id of the last response, empty for the first request", "default": "" }, "backtrace": { "type": "string", "title": "Backtrace", "description": "Backtrace, obtained from data.pagination.backtrace of the last response, empty for the first request", "default": "" } }, "type": "object", "title": "VideoSearchV5Request" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:4b3f71a14633a06266d1a360400bf802ee17b60d44d9fa0dd2ae6fb8fdfe01f7" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-search-fetch_video_search_v5" } }, "/apis/v1/tikhub/douyin/web/encrypt_uid_to_sec_user_id": { "get": { "description": "Douyin (web).\n\n### Purpose:\n- Encrypt user uid to sec_user_id\n### Parameters:\n- uid: User uid, which is the short_id of the Douyin number\n### Return:\n- User information\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_web_encrypt_uid_to_sec_user_id", "responses": { "200": { "description": "Successful Response\n\n### Return\n- User information", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin encrypt_uid_to_sec_user_id", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "55efe65d1328" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/web/encrypt_uid_to_sec_user_id", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_web_encrypt_uid_to_sec_user_id", "method": "GET", "path": "/apis/v1/tikhub/douyin/web/encrypt_uid_to_sec_user_id" }, "parameters": [ { "name": "uid", "in": "query", "required": true, "schema": { "type": "string", "description": "User uid, which is the short_id of the Douyin number", "title": "Uid" }, "description": "User uid, which is the short_id of the Douyin number", "example": "1673937488185292" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:4ced81916d3a065d67730a502526901ce6b14ead6029b1fe45962771f9e57926" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/web/encrypt_uid_to_sec_user_id?uid=1673937488185292' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-web-encrypt_uid_to_sec_user_id" } }, "/apis/v1/tikhub/douyin/web/fetch_batch_user_profile_v2": { "get": { "description": "Douyin (web).\n\n### Purpose:\n- Get batch user profile, up to 50 users\n### Parameters:\n- sec_user_ids: User sec_user_id list, separated by commas, up to 50\n### Return:\n- Batch user profile\n\n\nPublished reference price: $0.15 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_web_fetch_batch_user_profile_v2", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Batch user profile", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_batch_user_profile", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.15, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "ad9605ccb036" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/web/fetch_batch_user_profile_v2", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_web_fetch_batch_user_profile_v2", "method": "GET", "path": "/apis/v1/tikhub/douyin/web/fetch_batch_user_profile_v2" }, "parameters": [ { "name": "sec_user_ids", "in": "query", "required": true, "schema": { "type": "string", "description": "User sec_user_id list, separated by commas, up to 50", "title": "Sec User Ids", "pattern": "^[^,]*(?:,[^,]*){0,49}$" }, "description": "User sec_user_id list, separated by commas, up to 50", "example": "MS4wLjABAAAANXSltcLCzDGmdNFI2Q_QixVTr67NiYzjKOIP5s03CAE,MS4wLjABAAAAW9FWcqS7RdQAWPd2AA5fL_ilmqsIFUCQ_Iym6Yh9_cUa6ZRqVLjVQSUjlHrfXY1Y" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:42ef6035344c58858502dad193ab2c36a8317fe072e912cf194fb8e3012b1145" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/web/fetch_batch_user_profile_v2?sec_user_ids=MS4wLjABAAAANXSltcLCzDGmdNFI2Q_QixVTr67NiYzjKOIP5s03CAE%2CMS4wLjABAAAAW9FWcqS7RdQAWPd2AA5fL_ilmqsIFUCQ_Iym6Yh9_cUa6ZRqVLjVQSUjlHrfXY1Y' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-web-fetch_batch_user_profile_v2" } }, "/apis/v1/tikhub/douyin/web/fetch_cartoon_aweme": { "get": { "description": "Douyin (web).\n\n### Purpose:\n- Cartoon Video\n### Parameters:\n- count: Number per page, default is 16\n- refresh_index: Paging index, default is 1\n- cookie: User provided Cookie, it is recommended to use your own Douyin Cookie, otherwise there may be a problem of data duplication when paging\n- Guest cookie acquisition interface: https://api.tikhub.io/api/v1/douyin/web/fetch_douyin_web_guest_cookie\n\n### Return:\n- Cartoon Video data\n\nAPI references: `fetch_douyin_web_guest_cookie` = `GET /tikhub/douyin/web/fetch_douyin_web_guest_cookie` (operationId: `get_tikhub_douyin_web_fetch_douyin_web_guest_cookie`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_web_fetch_cartoon_aweme", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Cartoon Video data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_cartoon_aweme", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "15004ab7e339" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/web/fetch_cartoon_aweme", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_web_fetch_cartoon_aweme", "method": "GET", "path": "/apis/v1/tikhub/douyin/web/fetch_cartoon_aweme" }, "parameters": [ { "name": "cookie", "in": "query", "required": false, "schema": { "type": "string", "description": "User provided Cookie, it is recommended to use your own Douyin Cookie, otherwise there may be a problem of data duplication when paging", "title": "Cookie" }, "description": "User provided Cookie, it is recommended to use your own Douyin Cookie, otherwise there may be a problem of data duplication when paging" }, { "name": "count", "in": "query", "required": true, "schema": { "type": "integer", "description": "Number per page, default is 16", "title": "Count" }, "description": "Number per page, default is 16", "example": 16 }, { "name": "refresh_index", "in": "query", "required": false, "schema": { "type": "integer", "description": "Paging index, default is 1", "default": 1, "title": "Refresh Index" }, "description": "Paging index, default is 1" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e28dcff09086b9895d68964892d3da137af160afe1e635f673f9eccf308459d5" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/web/fetch_cartoon_aweme?count=16' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-web-fetch_cartoon_aweme" } }, "/apis/v1/tikhub/douyin/web/fetch_challenge_posts": { "post": { "description": "Douyin (web).\n\n### Purpose:\n- Challenge Posts\n### Parameters:\n- challenge_id: Challenge id\n- sort_type: Sort type\n - 0: Comprehensive sorting 1: Hottest sorting 2: Latest sorting\n- cursor: Cursor\n- count: Number\n- cookie: User provided Cookie, used to get more data\n### Return:\n- Challenge Posts\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_web_fetch_challenge_posts", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Challenge Posts", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_challenge_posts", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "36280293faaa" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/web/fetch_challenge_posts", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_web_fetch_challenge_posts", "method": "POST", "path": "/apis/v1/tikhub/douyin/web/fetch_challenge_posts" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "challenge_id": { "type": "string", "title": "Challenge Id", "description": "Challenge ID", "default": "1608846127610893" }, "sort_type": { "type": "integer", "title": "Sort Type", "description": "Sort type\n - 0: Comprehensive sorting 1: Hottest sorting 2: Latest sorting", "default": 0 }, "cursor": { "type": "integer", "title": "Cursor", "description": "Cursor", "default": 0 }, "count": { "type": "integer", "title": "Count", "description": "Count", "default": 20 }, "cookie": { "type": "string", "title": "Cookie", "description": "User provided Cookie", "default": "" } }, "type": "object", "title": "ChallengePostRequest" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:3f171565710e38111631279d17a4dde56949224d327576ca4e60d3f6c3ba1f75" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-web-fetch_challenge_posts" } }, "/apis/v1/tikhub/douyin/web/fetch_douyin_web_guest_cookie": { "get": { "description": "Douyin (web).\n\n### Purpose:\n- Get the guest Cookie of Douyin Web\n- Can be used to crawl data of Douyin Web, such as user videos, mix videos, etc.\n- Can fix identity to avoid duplicate data for some interfaces.\n- Please note: Guest Cookie cannot crawl all data, there are certain restrictions.\n- Can be used with open source projects to implement data crawling of Douyin Web using this interface.\n### Parameters:\n- user_agent: User browser agent\n### Return:\n- Guest Cookie\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_web_fetch_douyin_web_guest_cookie", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Guest Cookie", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_douyin_web_guest_cookie", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "714ed7219e2f" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/web/fetch_douyin_web_guest_cookie", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_web_fetch_douyin_web_guest_cookie", "method": "GET", "path": "/apis/v1/tikhub/douyin/web/fetch_douyin_web_guest_cookie" }, "parameters": [ { "name": "user_agent", "in": "query", "required": true, "schema": { "type": "string", "description": "User browser agent", "title": "User Agent" }, "description": "User browser agent", "example": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/90.0.4430.212 Safari/537.36" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:06cff03bcdfd7f5481a26196842e519bd07cca9931b9f821a22aff5e11eac175" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/web/fetch_douyin_web_guest_cookie?user_agent=Mozilla%2F5.0+%28Windows+NT+10.0%3B+Win64%3B+x64%29+AppleWebKit%2F537.36+%28KHTML%2C+like+Gecko%29+Chrome%2F90.0.4430.212+Safari%2F537.36' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-web-fetch_douyin_web_guest_cookie" } }, "/apis/v1/tikhub/douyin/web/fetch_food_aweme": { "get": { "description": "Douyin (web).\n\n### Purpose:\n- Food Video\n### Parameters:\n- count: Number per page, default is 16\n- refresh_index: Paging index, default is 1\n- cookie: User provided Cookie, it is recommended to use your own Douyin Cookie, otherwise there may be a problem of data duplication when paging\n- Guest cookie acquisition interface: https://api.tikhub.io/api/v1/douyin/web/fetch_douyin_web_guest_cookie\n\n### Return:\n- Food Video data\n\nAPI references: `fetch_douyin_web_guest_cookie` = `GET /tikhub/douyin/web/fetch_douyin_web_guest_cookie` (operationId: `get_tikhub_douyin_web_fetch_douyin_web_guest_cookie`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_web_fetch_food_aweme", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Food Video data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_food_aweme", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "747a6f20c107" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/web/fetch_food_aweme", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_web_fetch_food_aweme", "method": "GET", "path": "/apis/v1/tikhub/douyin/web/fetch_food_aweme" }, "parameters": [ { "name": "cookie", "in": "query", "required": false, "schema": { "type": "string", "description": "User provided Cookie, it is recommended to use your own Douyin Cookie, otherwise there may be a problem of data duplication when paging", "title": "Cookie" }, "description": "User provided Cookie, it is recommended to use your own Douyin Cookie, otherwise there may be a problem of data duplication when paging" }, { "name": "count", "in": "query", "required": true, "schema": { "type": "integer", "description": "Number per page, default is 16", "title": "Count" }, "description": "Number per page, default is 16", "example": 16 }, { "name": "refresh_index", "in": "query", "required": false, "schema": { "type": "integer", "description": "Paging index, default is 1", "default": 1, "title": "Refresh Index" }, "description": "Paging index, default is 1" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:8171ff12677f2f3e737e250ddb2a96fdcb654eb3f3e57c876601ceeeb79e3eb5" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/web/fetch_food_aweme?count=16' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-web-fetch_food_aweme" } }, "/apis/v1/tikhub/douyin/web/fetch_game_aweme": { "get": { "description": "Douyin (web).\n\n### Purpose:\n- Knowledge Video\n### Parameters:\n- count: Number per page, default is 16\n- refresh_index: Paging index, default is 1\n- cookie: User provided Cookie, it is recommended to use your own Douyin Cookie, otherwise there may be a problem of data duplication when paging\n- Guest cookie acquisition interface: https://api.tikhub.io/api/v1/douyin/web/fetch_douyin_web_guest_cookie\n\n### Return:\n- Game Video data\n\nAPI references: `fetch_douyin_web_guest_cookie` = `GET /tikhub/douyin/web/fetch_douyin_web_guest_cookie` (operationId: `get_tikhub_douyin_web_fetch_douyin_web_guest_cookie`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_web_fetch_game_aweme", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Game Video data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_game_aweme", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "3ae85a23696d" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/web/fetch_game_aweme", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_web_fetch_game_aweme", "method": "GET", "path": "/apis/v1/tikhub/douyin/web/fetch_game_aweme" }, "parameters": [ { "name": "cookie", "in": "query", "required": false, "schema": { "type": "string", "description": "User provided Cookie, it is recommended to use your own Douyin Cookie, otherwise there may be a problem of data duplication when paging", "title": "Cookie" }, "description": "User provided Cookie, it is recommended to use your own Douyin Cookie, otherwise there may be a problem of data duplication when paging" }, { "name": "count", "in": "query", "required": true, "schema": { "type": "integer", "description": "Number per page, default is 16", "title": "Count" }, "description": "Number per page, default is 16", "example": 16 }, { "name": "refresh_index", "in": "query", "required": false, "schema": { "type": "integer", "description": "Paging index, default is 1", "default": 1, "title": "Refresh Index" }, "description": "Paging index, default is 1" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:f749ccfc7056e26cdb94923a34d9e754ddda60cbef6f246f40ecf07ca88889b2" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/web/fetch_game_aweme?count=16' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-web-fetch_game_aweme" } }, "/apis/v1/tikhub/douyin/web/fetch_home_feed": { "post": { "description": "Douyin (web).\n\n### Purpose:\n- Get home feed data\n### Parameters:\n- count: Number, default is 10, it is recommended to keep it unchanged.\n- refresh_index: Refresh/paging index, start at 0 and +1 per page.\n - refresh_index=0: refresh (first entry / pull-to-refresh)\n - refresh_index>0: load-more (scroll down)\n- cookie: Optional, your web version of Douyin login Cookie. Returns a personalized feed for that account; uses the default Cookie if omitted.\n### Return:\n- Feed data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_web_fetch_home_feed", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Feed data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_home_feed", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "ff63c4092ac1" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/web/fetch_home_feed", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_web_fetch_home_feed", "method": "POST", "path": "/apis/v1/tikhub/douyin/web/fetch_home_feed" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "count": { "type": "integer", "title": "Count", "description": "Number, default is 10, it is recommended to keep it unchanged.", "default": 10 }, "refresh_index": { "type": "integer", "title": "Refresh Index", "description": "Refresh-paging index: 0=refresh (first page / pull-down), >0=load-more (scroll down), increment by 1 for next page\n\nUsage: Refresh/paging index, start at 0 and +1 per page.\n - refresh_index=0: refresh (first entry / pull-to-refresh)\n - refresh_index>0: load-more (scroll down)", "default": 0 }, "cookie": { "type": "string", "title": "Cookie", "description": "Optional: Your web Douyin login Cookie for a personalized feed; uses the default Cookie if omitted", "default": "" } }, "type": "object", "title": "Body_fetch_home_feed_api_v1_douyin_web_fetch_home_feed_post" } } } }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:df08eeea77e58ac145e2563a420d7d72b5a0ebd2dc2d9a0847223985994c8f93" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-web-fetch_home_feed" } }, "/apis/v1/tikhub/douyin/web/fetch_hot_search_result": { "get": { "description": "Douyin (web).\n\n### Purpose:\n- Get Douyin hot search results\n### Return:\n- Hot search results\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_web_fetch_hot_search_result", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Hot search results", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_hot_search_result", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "65c8bb34bb78" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/web/fetch_hot_search_result", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_web_fetch_hot_search_result", "method": "GET", "path": "/apis/v1/tikhub/douyin/web/fetch_hot_search_result" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:40c2224e493bc76bac9e0352b73d5f0f04d6cae6c1ac5dec9e44797fcf26e239" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-web-fetch_hot_search_result" } }, "/apis/v1/tikhub/douyin/web/fetch_knowledge_aweme": { "get": { "description": "Douyin (web).\n\n### Purpose:\n- Knowledge Video\n### Parameters:\n- count: Number per page, default is 16\n- refresh_index: Paging index, default is 1\n- cookie: User provided Cookie, it is recommended to use your own Douyin Cookie, otherwise there may be a problem of data duplication when paging\n- Guest cookie acquisition interface: https://api.tikhub.io/api/v1/douyin/web/fetch_douyin_web_guest_cookie\n\n### Return:\n- Knowledge Video data\n\nAPI references: `fetch_douyin_web_guest_cookie` = `GET /tikhub/douyin/web/fetch_douyin_web_guest_cookie` (operationId: `get_tikhub_douyin_web_fetch_douyin_web_guest_cookie`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_web_fetch_knowledge_aweme", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Knowledge Video data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_knowledge_aweme", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "387d7a2607c0" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/web/fetch_knowledge_aweme", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_web_fetch_knowledge_aweme", "method": "GET", "path": "/apis/v1/tikhub/douyin/web/fetch_knowledge_aweme" }, "parameters": [ { "name": "cookie", "in": "query", "required": false, "schema": { "type": "string", "description": "User provided Cookie, it is recommended to use your own Douyin Cookie, otherwise there may be a problem of data duplication when paging", "title": "Cookie" }, "description": "User provided Cookie, it is recommended to use your own Douyin Cookie, otherwise there may be a problem of data duplication when paging" }, { "name": "count", "in": "query", "required": true, "schema": { "type": "integer", "description": "Number per page, default is 16", "title": "Count" }, "description": "Number per page, default is 16", "example": 16 }, { "name": "refresh_index", "in": "query", "required": false, "schema": { "type": "integer", "description": "Paging index, default is 1", "default": 1, "title": "Refresh Index" }, "description": "Paging index, default is 1" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:77829f5188807f3c93b1817d50e208a329f57643e3e054685759645af9af448f" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/web/fetch_knowledge_aweme?count=16' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-web-fetch_knowledge_aweme" } }, "/apis/v1/tikhub/douyin/web/fetch_live_gift_ranking": { "get": { "description": "Douyin (web).\n\n### Purpose:\n- Get live room gift user ranking\n### Parameters:\n- room_id: Room room_id\n- rank_type: Leaderboard type, default is 30, no need to modify.\n### Return:\n- Leaderboard data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_web_fetch_live_gift_ranking", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Leaderboard data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_live_gift_ranking", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "c3349c145f7b" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/web/fetch_live_gift_ranking", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_web_fetch_live_gift_ranking", "method": "GET", "path": "/apis/v1/tikhub/douyin/web/fetch_live_gift_ranking" }, "parameters": [ { "name": "rank_type", "in": "query", "required": false, "schema": { "type": "integer", "description": "Leaderboard type, default is 30, no need to modify.", "default": 30, "title": "Rank Type" }, "description": "Leaderboard type, default is 30, no need to modify." }, { "name": "room_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Room room_id", "title": "Room Id" }, "description": "Room room_id", "example": "7356585666190461731" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:1396971891830ee5c593fa8eb09ce698b49ab9093ae23d57342d171cf1802d38" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/web/fetch_live_gift_ranking?room_id=7356585666190461731' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-web-fetch_live_gift_ranking" } }, "/apis/v1/tikhub/douyin/web/fetch_live_im_fetch": { "get": { "description": "Douyin (web).\n\n### Purpose:\n- Douyin live room danmaku parameters\n### Parameters:\n- room_id: Live room id\n- user_unique_id: User unique ID\n\n### Return:\n- Danmaku parameter data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_web_fetch_live_im_fetch", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Danmaku parameter data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_live_im_fetch", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "36f6d3b64a59" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/web/fetch_live_im_fetch", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_web_fetch_live_im_fetch", "method": "GET", "path": "/apis/v1/tikhub/douyin/web/fetch_live_im_fetch" }, "parameters": [ { "name": "room_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Live room id", "title": "Room Id" }, "description": "Live room id", "example": "7382517534467115826" }, { "name": "user_unique_id", "in": "query", "required": true, "schema": { "type": "string", "description": "User unique ID", "title": "User Unique Id" }, "description": "User unique ID", "example": "7382524529011246630" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:7ccd3bbafcbaabbb137931192ee3d9b3480a25ab95b3da8fc1d65ab68ed1c8ec" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/web/fetch_live_im_fetch?room_id=7382517534467115826&user_unique_id=7382524529011246630' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-web-fetch_live_im_fetch" } }, "/apis/v1/tikhub/douyin/web/fetch_multi_video": { "post": { "description": "Douyin (web).\n\n### Purpose\n- Batch Get Video Information, support photo, video, etc., up to 50 videos at a time.\n- If this interface fails, please use the APP interface instead.\n\n### Parameters\n- Root JSON body: List of video ids, up to 50 video ids are supported.\n\n### Return\n- Video data\n\n### Request body\nSend the request body as a JSON array of strings at the root.\n\n\nPublished reference price: $0.05 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_web_fetch_multi_video", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Video data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_multi_video", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.05, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "1d64aaf41b76" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/web/fetch_multi_video", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_web_fetch_multi_video", "method": "POST", "path": "/apis/v1/tikhub/douyin/web/fetch_multi_video" }, "requestBody": { "content": { "application/json": { "schema": { "items": { "type": "string" }, "type": "array", "title": "Aweme Ids", "description": " Send the request body as a JSON array of strings at the root." }, "example": [ "7372484719365098803", "7126745726494821640", "7372484719365098803", "7126745726494821640", "7372484719365098803", "7126745726494821640", "7372484719365098803", "7126745726494821640", "7372484719365098803", "7126745726494821640" ] } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:c04402c8a55acbd00de016a0fdd4bf0fce4aacc24a7df0b6cab25ecd943773ec" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/douyin/web/fetch_multi_video \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '[\n \"7372484719365098803\",\n \"7126745726494821640\",\n \"7372484719365098803\",\n \"7126745726494821640\",\n \"7372484719365098803\",\n \"7126745726494821640\",\n \"7372484719365098803\",\n \"7126745726494821640\",\n \"7372484719365098803\",\n \"7126745726494821640\"\n]'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-web-fetch_multi_video" } }, "/apis/v1/tikhub/douyin/web/fetch_multi_video_high_quality_play_url": { "post": { "description": "Douyin (web). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n If there are less than 50 videos, they will be charged as 50 videos.\n- Batch get the highest quality (original upload quality) play URL of videos\n- This interface will return the highest quality play URL, the original upload quality refers to the quality of the video when the user uploads it, usually the highest quality video has an uncompressed bitrate and the file header contains metadata.\n- The highest quality video link cannot be obtained directly from the Douyin APP or web version, and must be obtained through this interface.\n- This interface is very suitable for batch obtaining high-definition, watermark-free video links, suitable for scenarios that require high-quality videos, such as video editing, archiving, training models, etc.\n- Use concurrent requests to improve batch acquisition efficiency.\n- Support up to 50 video IDs.\n\n### Parameters\n- aweme_ids: Video id list, separated by commas, for example: \"123,456,789\", up to 50.\n\n### Return\n- total: Total count\n- success_count: Success count\n- failed_count: Failed count\n- videos: Video list, each video contains the following fields:\n - video_id: Video id\n - original_video_url: Highest quality (original upload quality) play URL\n - file_size: File size (bytes)\n - file_size_in_mb: File size (MB)\n - content_type: Content type\n - success: Whether successful\n - error: Error message (if failed)\n\n### Note\n- Due to the large number, the processing time may be slightly longer, please increase the waiting time.\n\n\nPublished reference price: $0.25 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_web_fetch_multi_video_high_quality_play_url", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- total: Total count\n- success_count: Success count\n- failed_count: Failed count\n- videos: Video list, each video contains the following fields:\n - video_id: Video id\n - original_video_url: Highest quality (original upload quality) play URL\n - file_size: File size (bytes)\n - file_size_in_mb: File size (MB)\n - content_type: Content type\n - success: Whether successful\n - error: Error message (if failed)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_multi_video_high_quality_play_url", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.25, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "d3758bbef814" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/web/fetch_multi_video_high_quality_play_url", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_web_fetch_multi_video_high_quality_play_url", "method": "POST", "path": "/apis/v1/tikhub/douyin/web/fetch_multi_video_high_quality_play_url" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "aweme_ids": { "type": "string", "title": "Aweme Ids", "description": "Video id list, separated by commas, for example: \"123,456,789\", up to 50.", "default": "7512756548356492544,7448118827402972455,7126745726494821640", "pattern": "^[^,]*(?:,[^,]*){0,49}$" }, "region": { "title": "Region", "description": "Optional, ISO country code (e.g. CN). Pass 'CN' for users in mainland China to get China-region CDN URLs for faster download.", "example": "CN", "type": [ "string", "null" ] } }, "type": "object", "title": "FetchMultiVideoHighQualityPlayUrlRequest" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:3b8bb9c1fb6fed8b06cdec223af57da8eacf0f2ca6d754d41ac687f3eea4da15" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-web-fetch_multi_video_high_quality_play_url" } }, "/apis/v1/tikhub/douyin/web/fetch_music_aweme": { "get": { "description": "Douyin (web).\n\n### Purpose:\n- Music Video\n### Parameters:\n- count: Number per page, default is 16\n- refresh_index: Paging index, default is 1\n- cookie: User provided Cookie, it is recommended to use your own Douyin Cookie, otherwise there may be a problem of data duplication when paging\n- Guest cookie acquisition interface: https://api.tikhub.io/api/v1/douyin/web/fetch_douyin_web_guest_cookie\n\n### Return:\n- Music Video data\n\nAPI references: `fetch_douyin_web_guest_cookie` = `GET /tikhub/douyin/web/fetch_douyin_web_guest_cookie` (operationId: `get_tikhub_douyin_web_fetch_douyin_web_guest_cookie`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_web_fetch_music_aweme", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Music Video data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_music_aweme", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "44788a6b2c6e" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/web/fetch_music_aweme", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_web_fetch_music_aweme", "method": "GET", "path": "/apis/v1/tikhub/douyin/web/fetch_music_aweme" }, "parameters": [ { "name": "cookie", "in": "query", "required": false, "schema": { "type": "string", "description": "User provided Cookie, it is recommended to use your own Douyin Cookie, otherwise there may be a problem of data duplication when paging", "title": "Cookie" }, "description": "User provided Cookie, it is recommended to use your own Douyin Cookie, otherwise there may be a problem of data duplication when paging" }, { "name": "count", "in": "query", "required": true, "schema": { "type": "integer", "description": "Number per page, default is 16", "title": "Count" }, "description": "Number per page, default is 16", "example": 16 }, { "name": "refresh_index", "in": "query", "required": false, "schema": { "type": "integer", "description": "Paging index, default is 1", "default": 1, "title": "Refresh Index" }, "description": "Paging index, default is 1" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:f11cd818b04376901d02acca978d80b58d01d16b331b5fe85e63f12c10c4c4d7" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/web/fetch_music_aweme?count=16' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-web-fetch_music_aweme" } }, "/apis/v1/tikhub/douyin/web/fetch_one_video": { "get": { "description": "Douyin (web). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get single video data V1. If this endpoint fails, try /tikhub/douyin/app/v3/fetch_one_video.\n\n### Parameters\n- aweme_id: Video id\n- need_anchor_info: Whether anchor information is needed, default is False, enabling it will show some anchor information about the video, such as location, merchant information, product showcase, etc., which may increase the interface response time.\n- If anchor information is not needed, it is recommended to keep the default value False, if the interface reports an error, you can try to turn off this parameter.\n\n### Return\n- Video data\n\n- Unavailable video results (including deleted or restricted videos) return HTTP 200 with `filter_detail` and are charged normally.\n\nAPI references: `fetch_one_video` = `GET /tikhub/douyin/app/v3/fetch_one_video` (operationId: `get_tikhub_douyin_app_v3_fetch_one_video`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_web_fetch_one_video", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Video data\n\n- Unavailable video results (including deleted or restricted videos) return HTTP 200 with `filter_detail` and are charged normally.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_one_video", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "73caf275802d" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/web/fetch_one_video", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_web_fetch_one_video", "method": "GET", "path": "/apis/v1/tikhub/douyin/web/fetch_one_video" }, "parameters": [ { "name": "aweme_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Video id", "title": "Aweme Id" }, "description": "Video id", "example": "7372484719365098803" }, { "name": "need_anchor_info", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether anchor information is needed, default is False, enabling it will show some anchor information about the video, such as location, merchant information, product showcase, etc., which may increase the interface response time.", "default": false, "title": "Need Anchor Info" }, "description": "Whether anchor information is needed, default is False, enabling it will show some anchor information about the video, such as location, merchant information, product showcase, etc., which may increase the interface response time.", "example": false } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:41b8807938153ce0c00cd660ecf4e5e0c1ceced49eed94f2692f57eb3612d8c6" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/web/fetch_one_video?aweme_id=7372484719365098803&need_anchor_info=false' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-web-fetch_one_video" } }, "/apis/v1/tikhub/douyin/web/fetch_one_video_by_share_url": { "get": { "description": "Douyin (web). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get single video data by sharing link (Essentially implemented based on the `/tikhub/douyin/web/fetch_one_video` interface, it is recommended to obtain the video ID by yourself to improve the interface response speed)\n- The returned video quality is higher than the APP interface, but the response fields are not as many as the APP interface.\n\n### Parameters\n- share_url: Share link\n\n### Return\n- Video data\n\n- Unavailable video results (including deleted or restricted videos) return HTTP 200 with `filter_detail` and are charged normally.\n\nAPI references: `fetch_one_video` = `GET /tikhub/douyin/web/fetch_one_video` (operationId: `get_tikhub_douyin_web_fetch_one_video`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_web_fetch_one_video_by_share_url", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Video data\n\n- Unavailable video results (including deleted or restricted videos) return HTTP 200 with `filter_detail` and are charged normally.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_one_video_by_share_url", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "c89462b8ad4c" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/web/fetch_one_video_by_share_url", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_web_fetch_one_video_by_share_url", "method": "GET", "path": "/apis/v1/tikhub/douyin/web/fetch_one_video_by_share_url" }, "parameters": [ { "name": "share_url", "in": "query", "required": true, "schema": { "type": "string", "description": "Share link", "title": "Share Url" }, "description": "Share link", "example": "https://v.douyin.com/e3x2fjE/" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:41b8807938153ce0c00cd660ecf4e5e0c1ceced49eed94f2692f57eb3612d8c6" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/web/fetch_one_video_by_share_url?share_url=https%3A%2F%2Fv.douyin.com%2Fe3x2fjE%2F' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-web-fetch_one_video_by_share_url" } }, "/apis/v1/tikhub/douyin/web/fetch_one_video_danmaku": { "get": { "description": "Douyin (web).\n\n### Purpose:\n- Get single video danmaku data\n### Parameters:\n- item_id: Video id\n- duration: Video total duration\n- end_time: End time\n- start_time: Start time\n### Return:\n- Video danmaku data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_web_fetch_one_video_danmaku", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Video danmaku data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_one_video_danmaku", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "1e951e2daef1" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/web/fetch_one_video_danmaku", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_web_fetch_one_video_danmaku", "method": "GET", "path": "/apis/v1/tikhub/douyin/web/fetch_one_video_danmaku" }, "parameters": [ { "name": "duration", "in": "query", "required": true, "schema": { "type": "integer", "description": "Video total duration", "title": "Duration" }, "description": "Video total duration", "example": 15134 }, { "name": "end_time", "in": "query", "required": true, "schema": { "type": "integer", "description": "End time", "title": "End Time" }, "description": "End time", "example": 15133 }, { "name": "item_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Video id", "title": "Item Id" }, "description": "Video id", "example": "7355433624046472498" }, { "name": "start_time", "in": "query", "required": true, "schema": { "type": "integer", "description": "Start time", "title": "Start Time" }, "description": "Start time", "example": 0 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:608cfcb2759ea017e69b87886c3dcd594234568a86a59f166024d77e7d5151e1" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/web/fetch_one_video_danmaku?duration=15134&end_time=15133&item_id=7355433624046472498&start_time=0' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-web-fetch_one_video_danmaku" } }, "/apis/v1/tikhub/douyin/web/fetch_query_user": { "post": { "description": "Douyin (web).\n\n### Purpose\n- Query Douyin user basic information\n\n### Parameters\n- Root JSON body: User ttwid Cookie, acquisition method: call `/tikhub/douyin/web/generate_ttwid` interface to get.\n\n### Return\n- User basic information\n\n### Request body\nSend the cookie value as a JSON string at the root of the request body.\n\nAPI references: `generate_ttwid` = `GET /tikhub/douyin/web/generate_ttwid` (operationId: `get_tikhub_douyin_web_generate_ttwid`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_web_fetch_query_user", "responses": { "200": { "description": "Successful Response\n\n### Return\n- User basic information", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_query_user", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "d0f5302dbd6e" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/web/fetch_query_user", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_web_fetch_query_user", "method": "POST", "path": "/apis/v1/tikhub/douyin/web/fetch_query_user" }, "requestBody": { "content": { "application/json": { "schema": { "type": "string", "title": "Cookie", "description": "User ttwid Cookie, acquisition method: call `/tikhub/douyin/web/generate_ttwid` interface to get. Send the cookie value as a JSON string at the root of the request body.\n\nAPI references: `generate_ttwid` = `GET /tikhub/douyin/web/generate_ttwid` (operationId: `get_tikhub_douyin_web_generate_ttwid`).", "default": "ttwid=1%7CNBG4pKnnBr32xpXszWA57PAooMT-02MTYJCyYl0fayI%7C1746172842%7Ce2aa988d355d220eb2fe8fb7e7bb22a51a46a933f969f768c5315fa73e372d5f;" }, "example": "ttwid=1%7CNBG4pKnnBr32xpXszWA57PAooMT-02MTYJCyYl0fayI%7C1746172842%7Ce2aa988d355d220eb2fe8fb7e7bb22a51a46a933f969f768c5315fa73e372d5f;" } } }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:f84b7639cae00fc508c926fdb062e3af2c08a51431713e711e0509cbd9080ff4" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/douyin/web/fetch_query_user \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '\"ttwid=1%7CNBG4pKnnBr32xpXszWA57PAooMT-02MTYJCyYl0fayI%7C1746172842%7Ce2aa988d355d220eb2fe8fb7e7bb22a51a46a933f969f768c5315fa73e372d5f;\"'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-web-fetch_query_user" } }, "/apis/v1/tikhub/douyin/web/fetch_related_posts": { "get": { "description": "Douyin (web).\n\n### Purpose:\n- Get related posts recommendation data\n### Parameters:\n- aweme_id: Video id\n- refresh_index: Paging index, default is 1, then increase by 1 each time for paging.\n- count: Number, default is 20, it is recommended to keep it unchanged.\n### Return:\n- Video data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_web_fetch_related_posts", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Video data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_related_posts", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "bcec4f5f704a" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/web/fetch_related_posts", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_web_fetch_related_posts", "method": "GET", "path": "/apis/v1/tikhub/douyin/web/fetch_related_posts" }, "parameters": [ { "name": "aweme_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Video id", "title": "Aweme Id" }, "description": "Video id", "example": "7393365489105358132" }, { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number, default is 20, it is recommended to keep it unchanged.", "default": 20, "title": "Count" }, "description": "Number, default is 20, it is recommended to keep it unchanged." }, { "name": "refresh_index", "in": "query", "required": false, "schema": { "type": "integer", "description": "Paging index, default is 1, then increase by 1 each time for paging.", "default": 1, "title": "Refresh Index" }, "description": "Paging index, default is 1, then increase by 1 each time for paging." } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:77955fe0d15635857c070a6aa28493a874baf14b10f13e971e4bab6f9bc7a032" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/web/fetch_related_posts?aweme_id=7393365489105358132' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-web-fetch_related_posts" } }, "/apis/v1/tikhub/douyin/web/fetch_series_aweme": { "get": { "description": "Douyin (web).\n\n### Purpose:\n- Series Video\n### Parameters:\n- offset: Page number, default is 0\n- count: Number per page, default is 16\n- content_type: Subtype, default is 0\n - 0: Hot list\n - 101: Sweet pet\n - 102: Funny\n - 104: Positive energy\n - 105: Growth\n - 106: Suspense\n - 109: Family\n - 110: Urban\n - 112: Fantasy\n - 113: Fantasy\n - 114: Workplace\n - 115: Youth\n - 116: Ancient costume\n - 117: Action\n - 119: Counterattack\n - 124: Other\n- cookie: User provided Cookie, it is recommended to use your own Douyin Cookie, otherwise there may be a problem of data duplication when paging\n- Guest cookie acquisition interface: https://api.tikhub.io/api/v1/douyin/web/fetch_douyin_web_guest_cookie\n\n### Return:\n- Series Video data\n\nAPI references: `fetch_douyin_web_guest_cookie` = `GET /tikhub/douyin/web/fetch_douyin_web_guest_cookie` (operationId: `get_tikhub_douyin_web_fetch_douyin_web_guest_cookie`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_web_fetch_series_aweme", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Series Video data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_series_aweme", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "eb2f3540d63e" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/web/fetch_series_aweme", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_web_fetch_series_aweme", "method": "GET", "path": "/apis/v1/tikhub/douyin/web/fetch_series_aweme" }, "parameters": [ { "name": "content_type", "in": "query", "required": true, "schema": { "type": "integer", "description": "Subtype, default is 0\n - 0: Hot list\n - 101: Sweet pet\n - 102: Funny\n - 104: Positive energy\n - 105: Growth\n - 106: Suspense\n - 109: Family\n - 110: Urban\n - 112: Fantasy\n - 113: Fantasy\n - 114: Workplace\n - 115: Youth\n - 116: Ancient costume\n - 117: Action\n - 119: Counterattack\n - 124: Other", "title": "Content Type" }, "description": "Subtype, default is 0\n - 0: Hot list\n - 101: Sweet pet\n - 102: Funny\n - 104: Positive energy\n - 105: Growth\n - 106: Suspense\n - 109: Family\n - 110: Urban\n - 112: Fantasy\n - 113: Fantasy\n - 114: Workplace\n - 115: Youth\n - 116: Ancient costume\n - 117: Action\n - 119: Counterattack\n - 124: Other", "example": 0 }, { "name": "cookie", "in": "query", "required": false, "schema": { "type": "string", "description": "User provided Cookie, it is recommended to use your own Douyin Cookie, otherwise there may be a problem of data duplication when paging", "title": "Cookie" }, "description": "User provided Cookie, it is recommended to use your own Douyin Cookie, otherwise there may be a problem of data duplication when paging" }, { "name": "count", "in": "query", "required": true, "schema": { "type": "integer", "description": "Number per page, default is 16", "title": "Count" }, "description": "Number per page, default is 16", "example": 16 }, { "name": "offset", "in": "query", "required": true, "schema": { "type": "integer", "description": "Page number, default is 0", "title": "Offset" }, "description": "Page number, default is 0", "example": 0 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:5bb6f55f689a7abac0b6dd189ee6c3de2e39d1091337005b5a59c6a79dd5474e" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/web/fetch_series_aweme?content_type=0&count=16&offset=0' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-web-fetch_series_aweme" } }, "/apis/v1/tikhub/douyin/web/fetch_user_collection_videos": { "post": { "description": "Douyin (web).\n\n### Purpose\n- Get user collection video data\n\n### Parameters\n- cookie: User's web version of Douyin Cookie (This interface requires users to provide their own Cookie)\n- max_cursor: Maximum cursor\n- counts: Maximum number\n\n### Return\n- User video data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_web_fetch_user_collection_videos", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- User video data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_user_collection_videos", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "168105ab5482" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/web/fetch_user_collection_videos", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_web_fetch_user_collection_videos", "method": "POST", "path": "/apis/v1/tikhub/douyin/web/fetch_user_collection_videos" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "Your web version of Douyin Cookie\n\nUsage: User's web version of Douyin Cookie (This interface requires users to provide their own Cookie)" }, "max_cursor": { "type": "integer", "title": "Max Cursor", "description": "Maximum cursor", "default": 0 }, "counts": { "type": "integer", "title": "Counts", "description": "Number per page", "default": 20 } }, "type": "object", "required": [ "cookie" ], "title": "Body_fetch_user_collection_videos_api_v1_douyin_web_fetch_user_collection_videos_post" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e7d85f832553f0fdfb8e24e1db16864ab8c323a52a22ee7c35cfa098ef581207" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-web-fetch_user_collection_videos" } }, "/apis/v1/tikhub/douyin/web/fetch_user_collects": { "post": { "description": "Douyin (web).\n\n### Purpose\n- Get user collection\n\n### Parameters\n- max_cursor: Maximum cursor\n- counts: Maximum number\n- cookie: User's web version of Douyin Cookie (This interface requires users to provide their own Cookie)\n\n### Return\n- User collection data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_web_fetch_user_collects", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- User collection data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_user_collects", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "52667cc9a00f" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/web/fetch_user_collects", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_web_fetch_user_collects", "method": "POST", "path": "/apis/v1/tikhub/douyin/web/fetch_user_collects" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "max_cursor": { "type": "integer", "title": "Max Cursor", "description": "Maximum cursor", "default": 0 }, "counts": { "type": "integer", "title": "Counts", "description": "Number per page", "default": 20 }, "cookie": { "type": "string", "title": "Cookie", "description": "Your web version of Douyin Cookie\n\nUsage: User's web version of Douyin Cookie (This interface requires users to provide their own Cookie)" } }, "type": "object", "required": [ "cookie" ], "title": "Body_fetch_user_collects_api_v1_douyin_web_fetch_user_collects_post" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:1ba0f8313386927d279cf13327e16ca96968a286856e11a98f15fb6f2570e682" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-web-fetch_user_collects" } }, "/apis/v1/tikhub/douyin/web/fetch_user_collects_videos": { "get": { "description": "Douyin (web).\n\n### Purpose\n- Get user collection data\n\n### Parameters\n- collects_id: Collection id\n- max_cursor: Maximum cursor\n- counts: Maximum number\n\n### Return\n- User video data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_web_fetch_user_collects_videos", "responses": { "200": { "description": "Successful Response\n\n### Return\n- User video data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_user_collects_videos", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "722eeb6f91f0" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/web/fetch_user_collects_videos", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_web_fetch_user_collects_videos", "method": "GET", "path": "/apis/v1/tikhub/douyin/web/fetch_user_collects_videos" }, "parameters": [ { "name": "collects_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Collection id", "title": "Collects Id" }, "description": "Collection id" }, { "name": "counts", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number per page", "default": 20, "title": "Counts" }, "description": "Number per page" }, { "name": "max_cursor", "in": "query", "required": false, "schema": { "type": "integer", "description": "Maximum cursor", "default": 0, "title": "Max Cursor" }, "description": "Maximum cursor" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:44bcdfb4c7a94fb10e7ebc4c065ce3fa885014430d44347355ca58219bbb9e69" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-web-fetch_user_collects_videos" } }, "/apis/v1/tikhub/douyin/web/fetch_user_fans_list": { "get": { "description": "Douyin (web).\n\n### Purpose:\n- Get user fans list\n- When requesting for the first time, pass `0` for max_time, pass `2` for source_type, and an empty fans list will be returned, which contains max_time, then pass the max_time returned by the previous request for paging each time, pass `1` for source_type, you can get the fans list.\n- If you do not request according to the above method, it may cause the returned data to contain duplicate data.\n\n### Parameters:\n- sec_user_id: User sec_user_id\n- max_time: Maximum timestamp, default is 0, get from the returned data later, used for paging.\n- count: Number, default is 20, it is recommended to keep it unchanged.\n- source_type: Source type, default is `1`, use `2` as the source type for the first request, and then use `1` as the source type for the subsequent request.\n### Return:\n- Fans list\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_web_fetch_user_fans_list", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Fans list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_user_fans_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "ad63cc50765e" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/web/fetch_user_fans_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_web_fetch_user_fans_list", "method": "GET", "path": "/apis/v1/tikhub/douyin/web/fetch_user_fans_list" }, "parameters": [ { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number, default is 20, it is recommended to keep it unchanged.", "default": 20, "title": "Count" }, "description": "Number, default is 20, it is recommended to keep it unchanged." }, { "name": "max_time", "in": "query", "required": false, "schema": { "type": "string", "description": "Maximum timestamp, default is 0, get from the returned data later, used for paging.", "default": "0", "title": "Max Time" }, "description": "Maximum timestamp, default is 0, get from the returned data later, used for paging." }, { "name": "sec_user_id", "in": "query", "required": false, "schema": { "type": "string", "description": "User sec_user_id", "default": "MS4wLjABAAAA9y04iBlVdeMQqTJbqsQZKb-tqWqWW29jPVJqideHT70", "title": "Sec User Id" }, "description": "User sec_user_id" }, { "name": "source_type", "in": "query", "required": false, "schema": { "type": "integer", "description": "Source type, default is `1`, use `2` as the source type for the first request, and then use `1` as the source type for the subsequent request.", "default": 1, "title": "Source Type" }, "description": "Source type, default is `1`, use `2` as the source type for the first request, and then use `1` as the source type for the subsequent request." } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e6bb3beadff0c2c949d89c2d70dbe6e8a48ef134256887ff83c8aa85f38c05b4" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-web-fetch_user_fans_list" } }, "/apis/v1/tikhub/douyin/web/fetch_user_following_list": { "get": { "description": "Douyin (web).\n\n### Purpose:\n- Get user following list\n- When requesting for the first time, pass `0` for max_time, pass `2` for source_type, and an empty fans list will be returned, which contains max_time, then pass the max_time returned by the previous request for paging each time, pass `1` for source_type, you can get the fans list.\n- If you do not request according to the above method, it may cause the returned data to contain duplicate data.\n\n### Parameters:\n- sec_user_id: User sec_user_id\n- max_time: Maximum timestamp, default is 0, get from the returned data later, used for paging.\n- count: Number, default is 20, it is recommended to keep it unchanged.\n- source_type: Source type, default is `1`, use `2` as the source type for the first request, and then use `1` as the source type for the subsequent request.\n### Return:\n- Following list\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_web_fetch_user_following_list", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Following list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_user_following_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "6d9009c47def" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/web/fetch_user_following_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_web_fetch_user_following_list", "method": "GET", "path": "/apis/v1/tikhub/douyin/web/fetch_user_following_list" }, "parameters": [ { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number, default is 20, it is recommended to keep it unchanged.", "default": 20, "title": "Count" }, "description": "Number, default is 20, it is recommended to keep it unchanged." }, { "name": "max_time", "in": "query", "required": false, "schema": { "type": "string", "description": "Maximum timestamp, default is 0, get from the returned data later, used for paging.", "default": "0", "title": "Max Time" }, "description": "Maximum timestamp, default is 0, get from the returned data later, used for paging." }, { "name": "sec_user_id", "in": "query", "required": false, "schema": { "type": "string", "description": "User sec_user_id", "default": "MS4wLjABAAAA9y04iBlVdeMQqTJbqsQZKb-tqWqWW29jPVJqideHT70", "title": "Sec User Id" }, "description": "User sec_user_id" }, { "name": "source_type", "in": "query", "required": false, "schema": { "type": "integer", "description": "Source type, default is `1`, use `2` as the source type for the first request, and then use `1` as the source type for the subsequent request.", "default": 1, "title": "Source Type" }, "description": "Source type, default is `1`, use `2` as the source type for the first request, and then use `1` as the source type for the subsequent request." } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:9e8d97243953db9cebebefde161c8620f9dbfd54968ec9f00af9a02964cc437b" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-web-fetch_user_following_list" } }, "/apis/v1/tikhub/douyin/web/fetch_user_like_videos": { "post": { "description": "Douyin (web).\n\n### Purpose\n- Get user like video data\n\n### Parameters\n- sec_user_id: User sec_user_id\n- max_cursor: Maximum cursor\n- counts: Maximum count number\n- cookie: User's web version of Douyin Cookie (This interface requires users to provide their own Cookie)\n\n### Return\n- User video data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_web_fetch_user_like_videos", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- User video data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_user_like_videos", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a8763b876825" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/web/fetch_user_like_videos", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_web_fetch_user_like_videos", "method": "POST", "path": "/apis/v1/tikhub/douyin/web/fetch_user_like_videos" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "sec_user_id": { "type": "string", "title": "Sec User Id", "description": "User sec_user_id" }, "max_cursor": { "type": "integer", "title": "Max Cursor", "description": "Maximum cursor", "default": 0 }, "counts": { "type": "integer", "title": "Counts", "description": "Number per page", "default": 20 }, "cookie": { "type": "string", "title": "Cookie", "description": "Your web version of Douyin Cookie\n\nUsage: User's web version of Douyin Cookie (This interface requires users to provide their own Cookie)" } }, "type": "object", "required": [ "sec_user_id" ], "title": "Body_fetch_user_like_videos_api_v1_douyin_web_fetch_user_like_videos_post" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e7d85f832553f0fdfb8e24e1db16864ab8c323a52a22ee7c35cfa098ef581207" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-web-fetch_user_like_videos" } }, "/apis/v1/tikhub/douyin/web/fetch_user_live_info_by_uid": { "get": { "description": "Douyin (web).\n\n### Purpose:\n- Get user live information by UID\n### Parameters:\n- uid: User UID\n### Return:\n- User live information, including room_id and live_status\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_web_fetch_user_live_info_by_uid", "responses": { "200": { "description": "Successful Response\n\n### Return\n- User live information, including room_id and live_status", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_user_live_info_by_uid", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "9fc643727220" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/web/fetch_user_live_info_by_uid", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_web_fetch_user_live_info_by_uid", "method": "GET", "path": "/apis/v1/tikhub/douyin/web/fetch_user_live_info_by_uid" }, "parameters": [ { "name": "uid", "in": "query", "required": true, "schema": { "type": "string", "description": "User UID", "title": "Uid" }, "description": "User UID", "example": "3081254195702747" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e6306382e903603a5aed24d8e802bcf03f47c5b54d0b27f4400e4e915c84bbf8" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/web/fetch_user_live_info_by_uid?uid=3081254195702747' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-web-fetch_user_live_info_by_uid" } }, "/apis/v1/tikhub/douyin/web/fetch_user_live_videos": { "get": { "description": "Douyin (web).\n\n### Purpose:\n- Get user live video data\n### Parameters:\n- webcast_id: Room webcast_id\n- Acquisition method:\n - Assuming your live room link is: https://www.douyin.com/root/live/376034101029\n - Then the live room webcast_id is: 376034101029\n - The webcast_id is the last number of the live room link, which is different from the room_id.\n### Return:\n- Live stream data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_web_fetch_user_live_videos", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Live stream data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_user_live_videos", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "b44836dfefde" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/web/fetch_user_live_videos", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_web_fetch_user_live_videos", "method": "GET", "path": "/apis/v1/tikhub/douyin/web/fetch_user_live_videos" }, "parameters": [ { "name": "webcast_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Room webcast_id", "title": "Webcast Id" }, "description": "Room webcast_id", "example": "376034101029" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:4f32493b05aaaccd789380b4dccf7929b8667e3eb031d402953c2bf4bb4ec7ae" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/web/fetch_user_live_videos?webcast_id=376034101029' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-web-fetch_user_live_videos" } }, "/apis/v1/tikhub/douyin/web/fetch_user_live_videos_by_room_id_v2": { "get": { "description": "Douyin (web).\n\n### Purpose:\n- Gets the live stream data of the specified user V2\n### Parameters:\n- room_id: Room room_id\n### Return:\n- Live stream data\n### Note:\nThe modify_time field is the last update time of the live room, which is equivalent to the start time. If the live stream is offline, it will not be reset to 0, but will always maintain the last update time.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_web_fetch_user_live_videos_by_room_id_v2", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Live stream data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_user_live_videos_by_room_id", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "849d102b69c4" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/web/fetch_user_live_videos_by_room_id_v2", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_web_fetch_user_live_videos_by_room_id_v2", "method": "GET", "path": "/apis/v1/tikhub/douyin/web/fetch_user_live_videos_by_room_id_v2" }, "parameters": [ { "name": "room_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Room room_id", "title": "Room Id" }, "description": "Room room_id", "example": "7462723839303093032" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:4f32493b05aaaccd789380b4dccf7929b8667e3eb031d402953c2bf4bb4ec7ae" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/web/fetch_user_live_videos_by_room_id_v2?room_id=7462723839303093032' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-web-fetch_user_live_videos_by_room_id_v2" } }, "/apis/v1/tikhub/douyin/web/fetch_user_live_videos_by_sec_uid": { "get": { "description": "Douyin (web).\n\n### Purpose\n- Get live video data of specified user by sec_uid\n### Parameters\n- sec_uid: User sec_uid, also called sec_user_id, can be found in the user's homepage link.\n### Return\n- Live stream data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_web_fetch_user_live_videos_by_sec_uid", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Live stream data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_user_live_videos_by_sec_uid", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "fcab3d7a190d" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/web/fetch_user_live_videos_by_sec_uid", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_web_fetch_user_live_videos_by_sec_uid", "method": "GET", "path": "/apis/v1/tikhub/douyin/web/fetch_user_live_videos_by_sec_uid" }, "parameters": [ { "name": "sec_uid", "in": "query", "required": true, "schema": { "type": "string", "description": "User sec_uid, also called sec_user_id, can be found in the user's homepage link.", "title": "Sec Uid" }, "description": "User sec_uid, also called sec_user_id, can be found in the user's homepage link.", "example": "MS4wLjABAAAAAIKOBr_x6p2fPVKOAhqG8LrC1lwwdWChifKEsl-TXFS-kGSGqpMBRexJdzoAfvUF" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:4f32493b05aaaccd789380b4dccf7929b8667e3eb031d402953c2bf4bb4ec7ae" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/web/fetch_user_live_videos_by_sec_uid?sec_uid=MS4wLjABAAAAAIKOBr_x6p2fPVKOAhqG8LrC1lwwdWChifKEsl-TXFS-kGSGqpMBRexJdzoAfvUF' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-web-fetch_user_live_videos_by_sec_uid" } }, "/apis/v1/tikhub/douyin/web/fetch_user_mix_videos": { "get": { "description": "Douyin (web).\n\n### Purpose\n- Get user mix video data\n\n### Parameters\n- mix_id: Mix id\n- max_cursor: Maximum cursor\n- counts: Maximum number\n\n### Return\n- User video data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_web_fetch_user_mix_videos", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- User video data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_user_mix_videos", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "0aa69e8a4152" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/web/fetch_user_mix_videos", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_web_fetch_user_mix_videos", "method": "GET", "path": "/apis/v1/tikhub/douyin/web/fetch_user_mix_videos" }, "parameters": [ { "name": "counts", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number per page", "default": 20, "title": "Counts" }, "description": "Number per page" }, { "name": "max_cursor", "in": "query", "required": false, "schema": { "type": "integer", "description": "Maximum cursor", "default": 0, "title": "Max Cursor" }, "description": "Maximum cursor" }, { "name": "mix_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Mix id", "title": "Mix Id" }, "description": "Mix id", "example": "7348687990509553679" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e7d85f832553f0fdfb8e24e1db16864ab8c323a52a22ee7c35cfa098ef581207" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/web/fetch_user_mix_videos?mix_id=7348687990509553679' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-web-fetch_user_mix_videos" } }, "/apis/v1/tikhub/douyin/web/fetch_user_post_videos": { "get": { "description": "Douyin (web).\n\n### Purpose:\n- Get user homepage video data\n- Note: Please try to use the APP interface instead of the WEB API, because the WEB API may be unstable.\n### Parameters:\n- sec_user_id: User sec_user_id\n- max_cursor: Paging cursor, pass 0 for the first request, and then pass the max_cursor returned by the previous request for paging each time.\n- count: Maximum count number, it is recommended not to exceed 20\n- filter_type: Filter type, optional parameters are as follows:\n - 0: Default sorting\n - 3: Sort by popularity\n- cookie: User's web version of Douyin Cookie (This interface can accept users to provide their own Cookie)\n### Return:\n- User video data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_web_fetch_user_post_videos", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- User video data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_user_post_videos", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "fc64572cbb87" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/web/fetch_user_post_videos", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_web_fetch_user_post_videos", "method": "GET", "path": "/apis/v1/tikhub/douyin/web/fetch_user_post_videos" }, "parameters": [ { "name": "cookie", "in": "query", "required": false, "schema": { "type": "string", "description": "Your web version of Douyin Cookie\n\nUsage: User's web version of Douyin Cookie (This interface can accept users to provide their own Cookie)", "title": "Cookie" }, "description": "Your web version of Douyin Cookie\n\nUsage: User's web version of Douyin Cookie (This interface can accept users to provide their own Cookie)" }, { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number per page\n\nUsage: Maximum count number, it is recommended not to exceed 20", "default": 20, "title": "Count" }, "description": "Number per page\n\nUsage: Maximum count number, it is recommended not to exceed 20" }, { "name": "filter_type", "in": "query", "required": false, "schema": { "type": "string", "description": "Filter type, optional parameters are as follows:\n - 0: Default sorting\n - 3: Sort by popularity", "default": "0", "title": "Filter Type" }, "description": "Filter type, optional parameters are as follows:\n - 0: Default sorting\n - 3: Sort by popularity" }, { "name": "max_cursor", "in": "query", "required": false, "schema": { "type": "string", "description": "Maximum cursor\n\nUsage: Paging cursor, pass 0 for the first request, and then pass the max_cursor returned by the previous request for paging each time.", "default": "0", "title": "Max Cursor" }, "description": "Maximum cursor\n\nUsage: Paging cursor, pass 0 for the first request, and then pass the max_cursor returned by the previous request for paging each time." }, { "name": "sec_user_id", "in": "query", "required": true, "schema": { "type": "string", "description": "User sec_user_id", "title": "Sec User Id" }, "description": "User sec_user_id", "example": "MS4wLjABAAAANXSltcLCzDGmdNFI2Q_QixVTr67NiYzjKOIP5s03CAE" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e7d85f832553f0fdfb8e24e1db16864ab8c323a52a22ee7c35cfa098ef581207" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/web/fetch_user_post_videos?sec_user_id=MS4wLjABAAAANXSltcLCzDGmdNFI2Q_QixVTr67NiYzjKOIP5s03CAE' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-web-fetch_user_post_videos" } }, "/apis/v1/tikhub/douyin/web/fetch_user_profile_by_short_id": { "get": { "description": "Douyin (web).\n\n### Purpose:\n- Get user information by Short ID\n### Parameters:\n- short_id: User Short ID\n### Return:\n- User information\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_web_fetch_user_profile_by_short_id", "responses": { "200": { "description": "Successful Response\n\n### Return\n- User information", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_user_profile_by_short_id", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "52a5d962f716" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/web/fetch_user_profile_by_short_id", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_web_fetch_user_profile_by_short_id", "method": "GET", "path": "/apis/v1/tikhub/douyin/web/fetch_user_profile_by_short_id" }, "parameters": [ { "name": "short_id", "in": "query", "required": true, "schema": { "type": "string", "description": "User Short ID", "title": "Short Id" }, "description": "User Short ID", "example": "114131058" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:4ced81916d3a065d67730a502526901ce6b14ead6029b1fe45962771f9e57926" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/web/fetch_user_profile_by_short_id?short_id=114131058' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-web-fetch_user_profile_by_short_id" } }, "/apis/v1/tikhub/douyin/web/fetch_user_profile_by_uid": { "get": { "description": "Douyin (web).\n\n### Purpose:\n- Get user information by UID\n### Parameters:\n- uid: User UID\n### Return:\n- User information\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_web_fetch_user_profile_by_uid", "responses": { "200": { "description": "Successful Response\n\n### Return\n- User information", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_user_profile_by_uid", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "4078f29ab08b" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/web/fetch_user_profile_by_uid", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_web_fetch_user_profile_by_uid", "method": "GET", "path": "/apis/v1/tikhub/douyin/web/fetch_user_profile_by_uid" }, "parameters": [ { "name": "uid", "in": "query", "required": true, "schema": { "type": "string", "description": "User UID", "title": "Uid" }, "description": "User UID", "example": "68141954464" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:4ced81916d3a065d67730a502526901ce6b14ead6029b1fe45962771f9e57926" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/web/fetch_user_profile_by_uid?uid=68141954464' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-web-fetch_user_profile_by_uid" } }, "/apis/v1/tikhub/douyin/web/fetch_video_channel_result": { "get": { "description": "Douyin (web).\n\n### Purpose:\n- Douyin video channel data\n- https://www.douyin.com/channel/300205\n### Parameters:\n- tag_id: Tag id, get from the URL\n- count: Number\n- refresh_index: Refresh index\n### Return:\n- Video channel data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_web_fetch_video_channel_result", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Video channel data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_video_channel_result", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "8e5e961d2659" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/web/fetch_video_channel_result", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_web_fetch_video_channel_result", "method": "GET", "path": "/apis/v1/tikhub/douyin/web/fetch_video_channel_result" }, "parameters": [ { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number", "default": 10, "title": "Count" }, "description": "Number" }, { "name": "refresh_index", "in": "query", "required": false, "schema": { "type": "integer", "description": "Refresh index", "default": 1, "title": "Refresh Index" }, "description": "Refresh index" }, { "name": "tag_id", "in": "query", "required": true, "schema": { "type": "integer", "description": "Tag id", "title": "Tag Id" }, "description": "Tag id", "example": 300203 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:4127f6a026f20c174e1a175e2d75b45cfe5b928060a3fe8b4ce1a44ef14399c1" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/web/fetch_video_channel_result?tag_id=300203' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-web-fetch_video_channel_result" } }, "/apis/v1/tikhub/douyin/web/fetch_video_comment_replies": { "get": { "description": "Douyin (web).\n\n### Purpose:\n- Get comment replies data of specified video\n### Parameters:\n- item_id: Video id\n- comment_id: Comment id\n- cursor: Cursor\n- count: Number\n### Return:\n- Comment replies data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_web_fetch_video_comment_replies", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Comment replies data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_video_comment_replies", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "4b21d2916283" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/web/fetch_video_comment_replies", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_web_fetch_video_comment_replies", "method": "GET", "path": "/apis/v1/tikhub/douyin/web/fetch_video_comment_replies" }, "parameters": [ { "name": "comment_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Comment id", "title": "Comment Id" }, "description": "Comment id", "example": "7354669356632638218" }, { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number", "default": 20, "title": "Count" }, "description": "Number" }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "integer", "description": "Cursor", "default": 0, "title": "Cursor" }, "description": "Cursor" }, { "name": "item_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Video id", "title": "Item Id" }, "description": "Video id", "example": "7354666303006723354" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:d1b5a3739a2655e9c1138197d2bc87bd42f714fa6dc0cb38642d07e4accfd2e4" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/web/fetch_video_comment_replies?comment_id=7354669356632638218&item_id=7354666303006723354' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-web-fetch_video_comment_replies" } }, "/apis/v1/tikhub/douyin/web/fetch_video_comments": { "get": { "description": "Douyin (web).\n\n### Purpose:\n- Get single video comments data\n### Parameters:\n- aweme_id: Video id\n- cursor: Cursor\n- count: Number\n### Return:\n- Comments data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_web_fetch_video_comments", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Comments data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_video_comments", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "b4f809c0b85f" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/web/fetch_video_comments", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_web_fetch_video_comments", "method": "GET", "path": "/apis/v1/tikhub/douyin/web/fetch_video_comments" }, "parameters": [ { "name": "aweme_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Video id", "title": "Aweme Id" }, "description": "Video id", "example": "7372484719365098803" }, { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number", "default": 20, "title": "Count" }, "description": "Number" }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "integer", "description": "Cursor", "default": 0, "title": "Cursor" }, "description": "Cursor" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:5afbde49f53f853801e28ddb1740e09af57f2fb850bdfeddd382d4c072fdfb0f" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/web/fetch_video_comments?aweme_id=7372484719365098803' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-web-fetch_video_comments" } }, "/apis/v1/tikhub/douyin/web/fetch_video_high_quality_play_url": { "get": { "description": "Douyin (web). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n\n- Get the highest quality (original upload quality) play URL of the video\n- This interface will return the highest quality play URL, the original upload quality refers to the quality of the video when the user uploads it, usually the highest quality video has an uncompressed bitrate and the file header contains metadata.\n- The highest quality video link cannot be obtained directly from the Douyin APP or web version, and must be obtained through this interface.\n- This interface is very suitable for obtaining high-definition, watermark-free video links, suitable for scenarios that require high-quality videos, such as video editing, archiving, training models, etc.\n- Generally, it can be played online, if not, you can try to download it using IDM or a browser and then play it.\n\n### Parameters\n- aweme_id: Video id, prefer to use aweme_id, if not available, use share_url.\n- share_url: Optional, share link, if the video id is provided, this parameter can be omitted.\n- region: Optional, ISO country code (e.g. \"CN\" / \"US\" / \"HK\") used as the request exit region.\n - Douyin returns CDN URLs based on the request IP. Pass `region=\"CN\"` for users\n located in mainland China to get China-region CDN URLs, which are significantly\n faster than overseas CDNs.\n - If omitted, the request uses the service's own exit IP (typically overseas).\n\n### Return\n- video_id: Video id\n- original_video_url: Highest quality (original upload quality) play URL\n- video_data: Video data, including metadata such as duration, size, etc.\n\n\nPublished reference price: $0.005 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_web_fetch_video_high_quality_play_url", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- video_id: Video id\n- original_video_url: Highest quality (original upload quality) play URL\n- video_data: Video data, including metadata such as duration, size, etc.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin fetch_video_high_quality_play_url", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.005, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "c0bceca07cc2" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/web/fetch_video_high_quality_play_url", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_web_fetch_video_high_quality_play_url", "method": "GET", "path": "/apis/v1/tikhub/douyin/web/fetch_video_high_quality_play_url" }, "parameters": [ { "name": "aweme_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Video id, prefer to use aweme_id, if not available, use share_url.", "title": "Aweme Id" }, "description": "Video id, prefer to use aweme_id, if not available, use share_url.", "example": "7512756548356492544" }, { "name": "region", "in": "query", "required": false, "schema": { "type": "string", "description": "Optional, ISO country code (e.g. CN/US/HK). Pass CN to get China-region CDN URLs for faster download in mainland China.\n\nUsage: Optional, ISO country code (e.g. \"CN\" / \"US\" / \"HK\") used as the request exit region.\n - Douyin returns CDN URLs based on the request IP. Pass `region=\"CN\"` for users\n located in mainland China to get China-region CDN URLs, which are significantly\n faster than overseas CDNs.\n - If omitted, the request uses the service's own exit IP (typically overseas).", "title": "Region" }, "description": "Optional, ISO country code (e.g. CN/US/HK). Pass CN to get China-region CDN URLs for faster download in mainland China.\n\nUsage: Optional, ISO country code (e.g. \"CN\" / \"US\" / \"HK\") used as the request exit region.\n - Douyin returns CDN URLs based on the request IP. Pass `region=\"CN\"` for users\n located in mainland China to get China-region CDN URLs, which are significantly\n faster than overseas CDNs.\n - If omitted, the request uses the service's own exit IP (typically overseas).", "example": "CN" }, { "name": "share_url", "in": "query", "required": false, "schema": { "type": "string", "description": "Optional, share link, if the video id is provided, this parameter can be omitted.", "title": "Share Url" }, "description": "Optional, share link, if the video id is provided, this parameter can be omitted.", "example": "https://www.douyin.com/video/7512756548356492544" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:6c0567a553f9ac73a1dd2f2857c8eeb5f810987b24f498ea1e3147342c3435bb" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-web-fetch_video_high_quality_play_url" } }, "/apis/v1/tikhub/douyin/web/generate_ttwid": { "get": { "description": "Douyin (web).\n\n### Purpose:\n- Generate ttwid\n### Return:\n- ttwid\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_web_generate_ttwid", "responses": { "200": { "description": "Successful Response\n\n### Return\n- ttwid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin generate_ttwid", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "18ed7d78658d" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/web/generate_ttwid", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_web_generate_ttwid", "method": "GET", "path": "/apis/v1/tikhub/douyin/web/generate_ttwid" }, "parameters": [ { "name": "user_agent", "in": "query", "required": false, "schema": { "type": "string", "default": "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:125.0) Gecko/20100101 Firefox/125.0", "title": "User Agent" }, "description": "User Agent" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:7f7b18196cef65139ee619c2b3111029ca5e8e25151b66baa9a244833e8c7d7c" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-web-generate_ttwid" } }, "/apis/v1/tikhub/douyin/web/generate_wss_xb_signature": { "get": { "description": "Douyin (web).\n\n### Purpose:\n- Generate danmu xb signature\n### Parameters:\n- user_agent: User browser agent\n- room_id: Room ID\n- user_unique_id: User unique ID\n### Return:\n- Danmu xb signature\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_web_generate_wss_xb_signature", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Danmu xb signature", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin generate_wss_xb_signature", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "c75780796035" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/web/generate_wss_xb_signature", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_web_generate_wss_xb_signature", "method": "GET", "path": "/apis/v1/tikhub/douyin/web/generate_wss_xb_signature" }, "parameters": [ { "name": "room_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Room ID", "title": "Room Id" }, "description": "Room ID", "example": "7382517534467115826" }, { "name": "user_agent", "in": "query", "required": true, "schema": { "type": "string", "description": "User browser agent", "title": "User Agent" }, "description": "User browser agent", "example": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/130.0.0.0 Safari/537.36 Edg/130.0.0.0" }, { "name": "user_unique_id", "in": "query", "required": true, "schema": { "type": "string", "description": "User unique ID", "title": "User Unique Id" }, "description": "User unique ID", "example": "7382524529011246630" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:c08e830229f7e9c81775c69ca821d47c78c4722f05381d619b94195058416254" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/web/generate_wss_xb_signature?room_id=7382517534467115826&user_agent=Mozilla%2F5.0+%28Windows+NT+10.0%3B+Win64%3B+x64%29+AppleWebKit%2F537.36+%28KHTML%2C+like+Gecko%29+Chrome%2F130.0.0.0+Safari%2F537.36+Edg%2F130.0.0.0&user_unique_id=7382524529011246630' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-web-generate_wss_xb_signature" } }, "/apis/v1/tikhub/douyin/web/get_all_aweme_id": { "post": { "description": "Douyin (web).\n\n### Purpose\n- Extract list video id (supports up to 20 links)\n\n### Parameters\n- Root JSON body: Video link list\n\n### Return\n- Video id list\n\n### Request body\nSend the request body as a JSON array of strings at the root.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_web_get_all_aweme_id", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Video id list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_all_aweme_id", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "c765c66c0878" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/web/get_all_aweme_id", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_web_get_all_aweme_id", "method": "POST", "path": "/apis/v1/tikhub/douyin/web/get_all_aweme_id" }, "requestBody": { "content": { "application/json": { "schema": { "items": { "type": "string" }, "type": "array", "title": "Url", "description": "Video link list Send the request body as a JSON array of strings at the root." }, "example": [ "https://v.douyin.com/iRNBho6u/", "https://v.douyin.com/iRNBho6u/", "https://www.iesdouyin.com/share/video/7298145681699622182/?region=CN&mid=7298145762238565171&u_code=l1j9bkbd&did=MS4wLjABAAAAtqpCx0hpOERbdSzQdjRZw-wFPxaqdbAzsKDmbJMUI3KWlMGQHC-n6dXAqa-dM2EP&iid=MS4wLjABAAAANwkJuWIRFOzg5uCpDRpMj4OX-QryoDgn-yYlXQnRwQQ&with_sec_did=1&titleType=title&share_sign=05kGlqGmR4_IwCX.ZGk6xuL0osNA..5ur7b0jbOx6cc-&share_version=170400&ts=1699262937&from_aid=6383&from_ssr=1&from=web_code_link", "https://www.douyin.com/video/7298145681699622182?previous_page=web_code_link", "https://www.douyin.com/video/7298145681699622182" ] } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:7dbc2e7209a1978d0c960fb0354dfd2a87be90e692c1029b7f776c7ac561fbf5" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/douyin/web/get_all_aweme_id \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '[\n \"https://v.douyin.com/iRNBho6u/\",\n \"https://v.douyin.com/iRNBho6u/\",\n \"https://www.iesdouyin.com/share/video/7298145681699622182/?region=CN&mid=7298145762238565171&u_code=l1j9bkbd&did=MS4wLjABAAAAtqpCx0hpOERbdSzQdjRZw-wFPxaqdbAzsKDmbJMUI3KWlMGQHC-n6dXAqa-dM2EP&iid=MS4wLjABAAAANwkJuWIRFOzg5uCpDRpMj4OX-QryoDgn-yYlXQnRwQQ&with_sec_did=1&titleType=title&share_sign=05kGlqGmR4_IwCX.ZGk6xuL0osNA..5ur7b0jbOx6cc-&share_version=170400&ts=1699262937&from_aid=6383&from_ssr=1&from=web_code_link\",\n \"https://www.douyin.com/video/7298145681699622182?previous_page=web_code_link\",\n \"https://www.douyin.com/video/7298145681699622182\"\n]'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-web-get_all_aweme_id" } }, "/apis/v1/tikhub/douyin/web/get_all_sec_user_id": { "post": { "description": "Douyin (web).\n\n### Purpose\n- Extract list user id\n\n### Parameters\n- Root JSON body: User homepage link list (supports up to 10 links)\n\n### Return\n- If the sec_user_id is successfully obtained from the link, the sec_user_id is returned, otherwise the original input link is returned, and the reason why the sec_user_id cannot be obtained can be manually verified later.\n\n### Request body\nSend the request body as a JSON array of strings at the root.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_web_get_all_sec_user_id", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- If the sec_user_id is successfully obtained from the link, the sec_user_id is returned, otherwise the original input link is returned, and the reason why the sec_user_id cannot be obtained can be manually verified later.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_all_sec_user_id", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "9b996565e5a7" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/web/get_all_sec_user_id", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_web_get_all_sec_user_id", "method": "POST", "path": "/apis/v1/tikhub/douyin/web/get_all_sec_user_id" }, "requestBody": { "content": { "application/json": { "schema": { "items": { "type": "string" }, "type": "array", "title": "Url", "description": "User homepage link list Send the request body as a JSON array of strings at the root." }, "example": [ "https://www.douyin.com/user/MS4wLjABAAAANXSltcLCzDGmdNFI2Q_QixVTr67NiYzjKOIP5s03CAE?vid=7285950278132616463", "https://www.douyin.com/user/MS4wLjABAAAAVsneOf144eGDFf8Xp9QNb1VW6ovXnNT5SqJBhJfe8KQBKWKDTWK5Hh-_i9mJzb8C", "https://v.douyin.com/idFqvUms/", "https://v.douyin.com/idFqvUms/" ] } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:aaee5992c4106207577a4521b01c9749b06e9a6282974c490209e97a18a25606" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/douyin/web/get_all_sec_user_id \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '[\n \"https://www.douyin.com/user/MS4wLjABAAAANXSltcLCzDGmdNFI2Q_QixVTr67NiYzjKOIP5s03CAE?vid=7285950278132616463\",\n \"https://www.douyin.com/user/MS4wLjABAAAAVsneOf144eGDFf8Xp9QNb1VW6ovXnNT5SqJBhJfe8KQBKWKDTWK5Hh-_i9mJzb8C\",\n \"https://v.douyin.com/idFqvUms/\",\n \"https://v.douyin.com/idFqvUms/\"\n]'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-web-get_all_sec_user_id" } }, "/apis/v1/tikhub/douyin/web/get_all_webcast_id": { "post": { "description": "Douyin (web).\n\n### Purpose\n- Extract list webcast id\n\n### Parameters\n- Root JSON body: Room link list (supports up to 20 links)\n\n### Return\n- Room id list\n\n### Request body\nSend the request body as a JSON array of strings at the root.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_web_get_all_webcast_id", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Room id list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_all_webcast_id", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "5f7ba29a6243" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/web/get_all_webcast_id", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_web_get_all_webcast_id", "method": "POST", "path": "/apis/v1/tikhub/douyin/web/get_all_webcast_id" }, "requestBody": { "content": { "application/json": { "schema": { "items": { "type": "string" }, "type": "array", "title": "Url", "description": "Room link list Send the request body as a JSON array of strings at the root." }, "example": [ "https://live.douyin.com/775841227732", "https://live.douyin.com/775841227732?room_id=7318296342189919011&enter_from_merge=web_share_link&enter_method=web_share_link&previous_page=app_code_link", "https://webcast.amemv.com/douyin/webcast/reflow/7318296342189919011?u_code=l1j9bkbd&did=MS4wLjABAAAAEs86TBQPNwAo-RGrcxWyCdwKhI66AK3Pqf3ieo6HaxI&iid=MS4wLjABAAAA0ptpM-zzoliLEeyvWOCUt-_dQza4uSjlIvbtIazXnCY&with_sec_did=1&use_link_command=1&ecom_share_track_params=&extra_params={\"from_request_id\":\"20231230162057EC005772A8EAA0199906\",\"im_channel_invite_id\":\"0\"}&user_id=3644207898042206&liveId=7318296342189919011&from=share&style=share&enter_method=click_share&roomId=7318296342189919011&activity_info={}", "https://v.douyin.com/i8tBR7hX/", "https://v.douyin.com/i8tBR7hX/" ] } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:d053a96202ab2c687e7594e2277e4bd0403badae64e0cedb9788ac3d50b95a5f" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/douyin/web/get_all_webcast_id \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '[\n \"https://live.douyin.com/775841227732\",\n \"https://live.douyin.com/775841227732?room_id=7318296342189919011&enter_from_merge=web_share_link&enter_method=web_share_link&previous_page=app_code_link\",\n \"https://webcast.amemv.com/douyin/webcast/reflow/7318296342189919011?u_code=l1j9bkbd&did=MS4wLjABAAAAEs86TBQPNwAo-RGrcxWyCdwKhI66AK3Pqf3ieo6HaxI&iid=MS4wLjABAAAA0ptpM-zzoliLEeyvWOCUt-_dQza4uSjlIvbtIazXnCY&with_sec_did=1&use_link_command=1&ecom_share_track_params=&extra_params={\\\"from_request_id\\\":\\\"20231230162057EC005772A8EAA0199906\\\",\\\"im_channel_invite_id\\\":\\\"0\\\"}&user_id=3644207898042206&liveId=7318296342189919011&from=share&style=share&enter_method=click_share&roomId=7318296342189919011&activity_info={}\",\n \"https://v.douyin.com/i8tBR7hX/\",\n \"https://v.douyin.com/i8tBR7hX/\"\n]'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-web-get_all_webcast_id" } }, "/apis/v1/tikhub/douyin/web/get_aweme_id": { "get": { "description": "Douyin (web).\n\n### Purpose:\n- Extract single video id\n### Parameters:\n- url: Video link\n### Return:\n- Video id\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_web_get_aweme_id", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Video id", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_aweme_id", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "2a72ae571295" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/web/get_aweme_id", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_web_get_aweme_id", "method": "GET", "path": "/apis/v1/tikhub/douyin/web/get_aweme_id" }, "parameters": [ { "name": "url", "in": "query", "required": true, "schema": { "type": "string", "title": "Url" }, "example": "https://www.douyin.com/video/7298145681699622182", "description": "Video link" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:60f4b7d549fdf2cd57ceb4cb3aa50b9239a24613822c7e53c2dbcb61b88e87ac" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/web/get_aweme_id?url=https%3A%2F%2Fwww.douyin.com%2Fvideo%2F7298145681699622182' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-web-get_aweme_id" } }, "/apis/v1/tikhub/douyin/web/get_sec_user_id": { "get": { "description": "Douyin (web).\n\n### Purpose:\n- Extract single user id\n### Parameters:\n- url: User homepage link\n### Return:\n- User sec_user_id\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_web_get_sec_user_id", "responses": { "200": { "description": "Successful Response\n\n### Return\n- User sec_user_id", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_sec_user_id", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "96de1514bfd3" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/web/get_sec_user_id", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_web_get_sec_user_id", "method": "GET", "path": "/apis/v1/tikhub/douyin/web/get_sec_user_id" }, "parameters": [ { "name": "url", "in": "query", "required": true, "schema": { "type": "string", "title": "Url" }, "example": "https://www.douyin.com/user/MS4wLjABAAAANXSltcLCzDGmdNFI2Q_QixVTr67NiYzjKOIP5s03CAE", "description": "User homepage link" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:c02941f832c4214115012117b72609fa486428f35f4f5b5a050d9358deaab354" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/web/get_sec_user_id?url=https%3A%2F%2Fwww.douyin.com%2Fuser%2FMS4wLjABAAAANXSltcLCzDGmdNFI2Q_QixVTr67NiYzjKOIP5s03CAE' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-web-get_sec_user_id" } }, "/apis/v1/tikhub/douyin/web/get_webcast_id": { "get": { "description": "Douyin (web).\n\n### Purpose:\n- Extract list webcast id\n### Parameters:\n- url: Room link\n### Return:\n- Room id\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_web_get_webcast_id", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Room id", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_webcast_id", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "ad067d6c287a" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/web/get_webcast_id", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_web_get_webcast_id", "method": "GET", "path": "/apis/v1/tikhub/douyin/web/get_webcast_id" }, "parameters": [ { "name": "url", "in": "query", "required": true, "schema": { "type": "string", "title": "Url" }, "example": "https://live.douyin.com/775841227732", "description": "Room link" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:b5a33af7078475855e8953600ce44f0377c1ea1dd31e5aff7e005d7762341a28" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/web/get_webcast_id?url=https%3A%2F%2Flive.douyin.com%2F775841227732' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-web-get_webcast_id" } }, "/apis/v1/tikhub/douyin/web/handler_shorten_url": { "get": { "description": "Handler Shorten Url\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_web_handler_shorten_url", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin handler_shorten_url", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "8929e7c8dc3d" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/web/handler_shorten_url", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_web_handler_shorten_url", "method": "GET", "path": "/apis/v1/tikhub/douyin/web/handler_shorten_url" }, "parameters": [ { "name": "target_url", "in": "query", "required": true, "schema": { "type": "string", "description": "Target URL to be converted", "title": "Target Url" }, "description": "Target URL to be converted", "example": "https://www.douyin.com/video/7575136499386720761" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e56c0f64759022cecb5502df30fd08faeb446c6d3a60cfc5fa77fb25dd390b27" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/web/handler_shorten_url?target_url=https%3A%2F%2Fwww.douyin.com%2Fvideo%2F7575136499386720761' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-web-handler_shorten_url" } }, "/apis/v1/tikhub/douyin/web/handler_user_profile": { "get": { "description": "Douyin (web).\n\n### Purpose:\n- Get information of specified user\n### Parameters:\n- sec_user_id: User sec_user_id\n### Return:\n- User information\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_web_handler_user_profile", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- User information", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin handler_user_profile", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "eaea99a1d303" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/web/handler_user_profile", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_web_handler_user_profile", "method": "GET", "path": "/apis/v1/tikhub/douyin/web/handler_user_profile" }, "parameters": [ { "name": "sec_user_id", "in": "query", "required": true, "schema": { "type": "string", "description": "User sec_user_id", "title": "Sec User Id" }, "description": "User sec_user_id", "example": "MS4wLjABAAAAW9FWcqS7RdQAWPd2AA5fL_ilmqsIFUCQ_Iym6Yh9_cUa6ZRqVLjVQSUjlHrfXY1Y" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:341539e411b93db6baa5bed99c92d549d02d8e735420963c120d407a371ff36a" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/web/handler_user_profile?sec_user_id=MS4wLjABAAAAW9FWcqS7RdQAWPd2AA5fL_ilmqsIFUCQ_Iym6Yh9_cUa6ZRqVLjVQSUjlHrfXY1Y' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-web-handler_user_profile" } }, "/apis/v1/tikhub/douyin/web/webcast_id_2_room_id": { "get": { "description": "Douyin (web).\n\n### Purpose:\n- Webcast id to room id\n### Parameters:\n- webcast_id: Webcast id\n### Return:\n- Room id\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_web_webcast_id_2_room_id", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Room id", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin webcast_id_2_room_id", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "8cf3f44260a4" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/web/webcast_id_2_room_id", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_web_webcast_id_2_room_id", "method": "GET", "path": "/apis/v1/tikhub/douyin/web/webcast_id_2_room_id" }, "parameters": [ { "name": "webcast_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Webcast id", "title": "Webcast Id" }, "description": "Webcast id", "example": "775841227732" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:b5a33af7078475855e8953600ce44f0377c1ea1dd31e5aff7e005d7762341a28" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/web/webcast_id_2_room_id?webcast_id=775841227732' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-web-webcast_id_2_room_id" } }, "/apis/v1/tikhub/douyin/xingtu/author_content_hot_comment_keywords_v1": { "get": { "description": "Douyin (xingtu). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get Author Content Hot Comment Keywords V1\n- The interface data is requested using an enterprise account, which is more expensive.\n\n### Parameters\n- kolId: User kolId, can be obtained from the following interfaces:\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_uid`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id`\n\n### Return\n- Author Content Hot Comment Keywords\n\nAPI references: `get_xingtu_kolid_by_sec_user_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_sec_user_id`); `get_xingtu_kolid_by_uid` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_uid` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_uid`); `get_xingtu_kolid_by_unique_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_unique_id`).\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_author_content_hot_comment_keywords_v1", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Author Content Hot Comment Keywords", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin author_content_hot_comment_keywords", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "848994720c41" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu/author_content_hot_comment_keywords_v1", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_author_content_hot_comment_keywords_v1", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu/author_content_hot_comment_keywords_v1" }, "parameters": [ { "name": "kolId", "in": "query", "required": true, "schema": { "type": "string", "description": "User kolId, can be obtained from the following interfaces:\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_uid`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id`\n\nAPI references: `get_xingtu_kolid_by_sec_user_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_sec_user_id`); `get_xingtu_kolid_by_uid` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_uid` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_uid`); `get_xingtu_kolid_by_unique_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_unique_id`).", "title": "Kolid" }, "description": "User kolId, can be obtained from the following interfaces:\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_uid`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id`\n\nAPI references: `get_xingtu_kolid_by_sec_user_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_sec_user_id`); `get_xingtu_kolid_by_uid` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_uid` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_uid`); `get_xingtu_kolid_by_unique_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_unique_id`).", "example": "7048929565493690398" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:ee27550c7c208be98c4a9396caffefb378f6ac46d4f1f6014478d848cee02259" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/xingtu/author_content_hot_comment_keywords_v1?kolId=7048929565493690398' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu-author_content_hot_comment_keywords_v1" } }, "/apis/v1/tikhub/douyin/xingtu/author_hot_comment_tokens_v1": { "get": { "description": "Douyin (xingtu). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get Author Hot Comment Tokens V1\n- The interface data is requested using an enterprise account, which is more expensive.\n\n### Parameters\n- kolId: User kolId, can be obtained from the following interfaces:\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_uid`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id`\n\n### Return\n- Author Hot Comment Tokens\n\nAPI references: `get_xingtu_kolid_by_sec_user_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_sec_user_id`); `get_xingtu_kolid_by_uid` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_uid` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_uid`); `get_xingtu_kolid_by_unique_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_unique_id`).\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_author_hot_comment_tokens_v1", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Author Hot Comment Tokens", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin author_hot_comment_tokens", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "3c549a169ab8" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu/author_hot_comment_tokens_v1", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_author_hot_comment_tokens_v1", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu/author_hot_comment_tokens_v1" }, "parameters": [ { "name": "kolId", "in": "query", "required": true, "schema": { "type": "string", "description": "User kolId, can be obtained from the following interfaces:\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_uid`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id`\n\nAPI references: `get_xingtu_kolid_by_sec_user_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_sec_user_id`); `get_xingtu_kolid_by_uid` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_uid` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_uid`); `get_xingtu_kolid_by_unique_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_unique_id`).", "title": "Kolid" }, "description": "User kolId, can be obtained from the following interfaces:\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_uid`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id`\n\nAPI references: `get_xingtu_kolid_by_sec_user_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_sec_user_id`); `get_xingtu_kolid_by_uid` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_uid` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_uid`); `get_xingtu_kolid_by_unique_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_unique_id`).", "example": "7048929565493690398" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:d4983e4ec2a78bfe4b5c7cf35ff3af47854168f7815572cf9a33549ed548a965" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/xingtu/author_hot_comment_tokens_v1?kolId=7048929565493690398' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu-author_hot_comment_tokens_v1" } }, "/apis/v1/tikhub/douyin/xingtu/get_sign_image": { "get": { "description": "Douyin (xingtu). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Parse encrypted XingTu image and get accessible image URL\n\n### Parameters\n- uri: Image URI, usually obtained from other XingTu API responses\n - Example: `tos-cn-i-0813c000-ce/oMKzDA3A9QGAuebfsDIAwlDoAfCFEEzSEw8FQZ`\n- durationTS: Duration in seconds, default 86400 (24 hours)\n- format: Image format, default webp, supports: webp, jpg, png, etc.\n\n### Return\n- Parsed image data with accessible image URL\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_get_sign_image", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Parsed image data with accessible image URL", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_sign_image", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "daffc6eb74d8" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu/get_sign_image", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_get_sign_image", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu/get_sign_image" }, "parameters": [ { "name": "durationTS", "in": "query", "required": false, "schema": { "type": "integer", "description": "Duration in seconds, default 86400 (24 hours)", "default": 86400, "title": "Durationts" }, "description": "Duration in seconds, default 86400 (24 hours)", "example": 86400 }, { "name": "format", "in": "query", "required": false, "schema": { "type": "string", "description": "Image format, default webp, supports: webp, jpg, png, etc.", "default": "webp", "title": "Format" }, "description": "Image format, default webp, supports: webp, jpg, png, etc.", "example": "webp" }, { "name": "uri", "in": "query", "required": true, "schema": { "type": "string", "description": "Image URI, usually obtained from other XingTu API responses\n - Example: `tos-cn-i-0813c000-ce/oMKzDA3A9QGAuebfsDIAwlDoAfCFEEzSEw8FQZ`", "title": "Uri" }, "description": "Image URI, usually obtained from other XingTu API responses\n - Example: `tos-cn-i-0813c000-ce/oMKzDA3A9QGAuebfsDIAwlDoAfCFEEzSEw8FQZ`", "example": "tos-cn-i-0813c000-ce/oMKzDA3A9QGAuebfsDIAwlDoAfCFEEzSEw8FQZ" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:115c7967155669ddec1abb9360cbea7cad294eed467c54e3e253efd423f74789" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/xingtu/get_sign_image?durationTS=86400&format=webp&uri=tos-cn-i-0813c000-ce%2FoMKzDA3A9QGAuebfsDIAwlDoAfCFEEzSEw8FQZ' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu-get_sign_image" } }, "/apis/v1/tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id": { "get": { "description": "Douyin (xingtu). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get XingTu kolid by Douyin sec_user_id\n\n### Parameters\n- sec_user_id: sec_user_id, can be obtained from the following interfaces:\n - `/tikhub/douyin/web/handler_user_profile`\n - `/tikhub/douyin/app/v3/handler_user_profile`\n\n### Return\n- XingTu kolid\n\nAPI references: `handler_user_profile` = `GET /tikhub/douyin/app/v3/handler_user_profile` (operationId: `get_tikhub_douyin_app_v3_handler_user_profile`); `handler_user_profile` = `GET /tikhub/douyin/web/handler_user_profile` (operationId: `get_tikhub_douyin_web_handler_user_profile`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_get_xingtu_kolid_by_sec_user_id", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- XingTu kolid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_xingtu_kolid_by_sec_user_id", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "5a0a5b131062" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu/get_xingtu_kolid_by_sec_user_id", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_get_xingtu_kolid_by_sec_user_id", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id" }, "parameters": [ { "name": "sec_user_id", "in": "query", "required": true, "schema": { "type": "string", "description": "sec_user_id, can be obtained from the following interfaces:\n - `/tikhub/douyin/web/handler_user_profile`\n - `/tikhub/douyin/app/v3/handler_user_profile`\n\nAPI references: `handler_user_profile` = `GET /tikhub/douyin/app/v3/handler_user_profile` (operationId: `get_tikhub_douyin_app_v3_handler_user_profile`); `handler_user_profile` = `GET /tikhub/douyin/web/handler_user_profile` (operationId: `get_tikhub_douyin_web_handler_user_profile`).", "title": "Sec User Id" }, "description": "sec_user_id, can be obtained from the following interfaces:\n - `/tikhub/douyin/web/handler_user_profile`\n - `/tikhub/douyin/app/v3/handler_user_profile`\n\nAPI references: `handler_user_profile` = `GET /tikhub/douyin/app/v3/handler_user_profile` (operationId: `get_tikhub_douyin_app_v3_handler_user_profile`); `handler_user_profile` = `GET /tikhub/douyin/web/handler_user_profile` (operationId: `get_tikhub_douyin_web_handler_user_profile`).", "example": "MS4wLjABAAAAoxwUZouIdKL6sZ8EB96KDjkrhfBMS1KbCgsMJR1kIUs" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:32f54aeca07fb6595e9acb0dc7a020932bab17df0a8a9586c96dc6208cb76b4b" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id?sec_user_id=MS4wLjABAAAAoxwUZouIdKL6sZ8EB96KDjkrhfBMS1KbCgsMJR1kIUs' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu-get_xingtu_kolid_by_sec_user_id" } }, "/apis/v1/tikhub/douyin/xingtu/get_xingtu_kolid_by_uid": { "get": { "description": "Douyin (xingtu). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get XingTu kolid by Douyin User ID\n\n### Parameters\n- uid: User ID, can be obtained from the following interfaces:\n - `/tikhub/douyin/web/fetch_user_profile_by_uid`\n - `/tikhub/douyin/web/fetch_user_profile_by_short_id`\n - `/tikhub/douyin/web/handler_user_profile`\n - `/tikhub/douyin/app/v3/handler_user_profile`\n\n### Return\n- XingTu kolid\n\nAPI references: `fetch_user_profile_by_short_id` = `GET /tikhub/douyin/web/fetch_user_profile_by_short_id` (operationId: `get_tikhub_douyin_web_fetch_user_profile_by_short_id`); `fetch_user_profile_by_uid` = `GET /tikhub/douyin/web/fetch_user_profile_by_uid` (operationId: `get_tikhub_douyin_web_fetch_user_profile_by_uid`); `handler_user_profile` = `GET /tikhub/douyin/app/v3/handler_user_profile` (operationId: `get_tikhub_douyin_app_v3_handler_user_profile`); `handler_user_profile` = `GET /tikhub/douyin/web/handler_user_profile` (operationId: `get_tikhub_douyin_web_handler_user_profile`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_get_xingtu_kolid_by_uid", "responses": { "200": { "description": "Successful Response\n\n### Return\n- XingTu kolid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_xingtu_kolid_by_uid", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "887a5abd58a1" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu/get_xingtu_kolid_by_uid", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_get_xingtu_kolid_by_uid", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu/get_xingtu_kolid_by_uid" }, "parameters": [ { "name": "uid", "in": "query", "required": true, "schema": { "type": "string", "description": "User ID, can be obtained from the following interfaces:\n - `/tikhub/douyin/web/fetch_user_profile_by_uid`\n - `/tikhub/douyin/web/fetch_user_profile_by_short_id`\n - `/tikhub/douyin/web/handler_user_profile`\n - `/tikhub/douyin/app/v3/handler_user_profile`\n\nAPI references: `fetch_user_profile_by_short_id` = `GET /tikhub/douyin/web/fetch_user_profile_by_short_id` (operationId: `get_tikhub_douyin_web_fetch_user_profile_by_short_id`); `fetch_user_profile_by_uid` = `GET /tikhub/douyin/web/fetch_user_profile_by_uid` (operationId: `get_tikhub_douyin_web_fetch_user_profile_by_uid`); `handler_user_profile` = `GET /tikhub/douyin/app/v3/handler_user_profile` (operationId: `get_tikhub_douyin_app_v3_handler_user_profile`); `handler_user_profile` = `GET /tikhub/douyin/web/handler_user_profile` (operationId: `get_tikhub_douyin_web_handler_user_profile`).", "title": "Uid" }, "description": "User ID, can be obtained from the following interfaces:\n - `/tikhub/douyin/web/fetch_user_profile_by_uid`\n - `/tikhub/douyin/web/fetch_user_profile_by_short_id`\n - `/tikhub/douyin/web/handler_user_profile`\n - `/tikhub/douyin/app/v3/handler_user_profile`\n\nAPI references: `fetch_user_profile_by_short_id` = `GET /tikhub/douyin/web/fetch_user_profile_by_short_id` (operationId: `get_tikhub_douyin_web_fetch_user_profile_by_short_id`); `fetch_user_profile_by_uid` = `GET /tikhub/douyin/web/fetch_user_profile_by_uid` (operationId: `get_tikhub_douyin_web_fetch_user_profile_by_uid`); `handler_user_profile` = `GET /tikhub/douyin/app/v3/handler_user_profile` (operationId: `get_tikhub_douyin_app_v3_handler_user_profile`); `handler_user_profile` = `GET /tikhub/douyin/web/handler_user_profile` (operationId: `get_tikhub_douyin_web_handler_user_profile`).", "example": "70452002324" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:a29a4feb70eb01467b83dfba3e3b130f041417f6e7116b1276b3891343f23d44" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/xingtu/get_xingtu_kolid_by_uid?uid=70452002324' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu-get_xingtu_kolid_by_uid" } }, "/apis/v1/tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id": { "get": { "description": "Douyin (xingtu). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get XingTu kolid by Douyin unique_id\n\n### Parameters\n- unique_id: unique_id, can be obtained from the following interfaces:\n - `/tikhub/douyin/web/handler_user_profile`\n - `/tikhub/douyin/app/v3/handler_user_profile`\n\n### Return\n- XingTu kolid\n\nAPI references: `handler_user_profile` = `GET /tikhub/douyin/app/v3/handler_user_profile` (operationId: `get_tikhub_douyin_app_v3_handler_user_profile`); `handler_user_profile` = `GET /tikhub/douyin/web/handler_user_profile` (operationId: `get_tikhub_douyin_web_handler_user_profile`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_get_xingtu_kolid_by_unique_id", "responses": { "200": { "description": "Successful Response\n\n### Return\n- XingTu kolid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_xingtu_kolid_by_unique_id", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "694820c6fc31" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu/get_xingtu_kolid_by_unique_id", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_get_xingtu_kolid_by_unique_id", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id" }, "parameters": [ { "name": "unique_id", "in": "query", "required": true, "schema": { "type": "string", "description": "unique_id, can be obtained from the following interfaces:\n - `/tikhub/douyin/web/handler_user_profile`\n - `/tikhub/douyin/app/v3/handler_user_profile`\n\nAPI references: `handler_user_profile` = `GET /tikhub/douyin/app/v3/handler_user_profile` (operationId: `get_tikhub_douyin_app_v3_handler_user_profile`); `handler_user_profile` = `GET /tikhub/douyin/web/handler_user_profile` (operationId: `get_tikhub_douyin_web_handler_user_profile`).", "title": "Unique Id" }, "description": "unique_id, can be obtained from the following interfaces:\n - `/tikhub/douyin/web/handler_user_profile`\n - `/tikhub/douyin/app/v3/handler_user_profile`\n\nAPI references: `handler_user_profile` = `GET /tikhub/douyin/app/v3/handler_user_profile` (operationId: `get_tikhub_douyin_app_v3_handler_user_profile`); `handler_user_profile` = `GET /tikhub/douyin/web/handler_user_profile` (operationId: `get_tikhub_douyin_web_handler_user_profile`).", "example": "m6640150" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:a29a4feb70eb01467b83dfba3e3b130f041417f6e7116b1276b3891343f23d44" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id?unique_id=m6640150' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu-get_xingtu_kolid_by_unique_id" } }, "/apis/v1/tikhub/douyin/xingtu/kol_audience_portrait_v1": { "get": { "description": "Douyin (xingtu). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get kol Audience Portrait V1\n- The interface data is requested using an enterprise account, which is more expensive.\n\n### Parameters\n- kolId: User kolId, can be obtained from the following interfaces:\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_uid`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id`\n\n### Return\n- kol Audience Portrait\n\nAPI references: `get_xingtu_kolid_by_sec_user_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_sec_user_id`); `get_xingtu_kolid_by_uid` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_uid` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_uid`); `get_xingtu_kolid_by_unique_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_unique_id`).\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_kol_audience_portrait_v1", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- kol Audience Portrait", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin kol_audience_portrait", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "5e5a84e800ae" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu/kol_audience_portrait_v1", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_kol_audience_portrait_v1", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu/kol_audience_portrait_v1" }, "parameters": [ { "name": "kolId", "in": "query", "required": true, "schema": { "type": "string", "description": "User kolId, can be obtained from the following interfaces:\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_uid`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id`\n\nAPI references: `get_xingtu_kolid_by_sec_user_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_sec_user_id`); `get_xingtu_kolid_by_uid` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_uid` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_uid`); `get_xingtu_kolid_by_unique_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_unique_id`).", "title": "Kolid" }, "description": "User kolId, can be obtained from the following interfaces:\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_uid`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id`\n\nAPI references: `get_xingtu_kolid_by_sec_user_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_sec_user_id`); `get_xingtu_kolid_by_uid` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_uid` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_uid`); `get_xingtu_kolid_by_unique_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_unique_id`).", "example": "7048929565493690398" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:26a066536104e3f8ba899d4f3e04c30faa5c37a8d77216d581535e909c360840" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/xingtu/kol_audience_portrait_v1?kolId=7048929565493690398' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu-kol_audience_portrait_v1" } }, "/apis/v1/tikhub/douyin/xingtu/kol_base_info_v1": { "get": { "description": "Douyin (xingtu). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get kol Base Info V1\n- The interface data is requested using an enterprise account, which is more expensive.\n\n### Parameters\n- kolId: User kolId, can be obtained from the following interfaces:\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_uid`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id`\n- platformChannel:\n - Platform channel, supports the following parameters:\n - _1 :Douyin Video\n - _10 :Douyin Live\n\n### Return\n- kol Base Info\n\nAPI references: `get_xingtu_kolid_by_sec_user_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_sec_user_id`); `get_xingtu_kolid_by_uid` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_uid` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_uid`); `get_xingtu_kolid_by_unique_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_unique_id`).\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_kol_base_info_v1", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- kol Base Info", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin kol_base_info", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "ecb52bf62ce2" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu/kol_base_info_v1", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_kol_base_info_v1", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu/kol_base_info_v1" }, "parameters": [ { "name": "kolId", "in": "query", "required": true, "schema": { "type": "string", "description": "User kolId, can be obtained from the following interfaces:\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_uid`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id`\n\nAPI references: `get_xingtu_kolid_by_sec_user_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_sec_user_id`); `get_xingtu_kolid_by_uid` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_uid` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_uid`); `get_xingtu_kolid_by_unique_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_unique_id`).", "title": "Kolid" }, "description": "User kolId, can be obtained from the following interfaces:\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_uid`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id`\n\nAPI references: `get_xingtu_kolid_by_sec_user_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_sec_user_id`); `get_xingtu_kolid_by_uid` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_uid` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_uid`); `get_xingtu_kolid_by_unique_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_unique_id`).", "example": "7048929565493690398" }, { "name": "platformChannel", "in": "query", "required": true, "schema": { "type": "string", "description": "- Platform channel, supports the following parameters:\n - _1 :Douyin Video\n - _10 :Douyin Live", "title": "Platformchannel" }, "description": "- Platform channel, supports the following parameters:\n - _1 :Douyin Video\n - _10 :Douyin Live", "example": "_1" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:f5cef375f335fece2e3aba022d7be02ca247b8f2f9441ac27003502bbbaa0824" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/xingtu/kol_base_info_v1?kolId=7048929565493690398&platformChannel=_1' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu-kol_base_info_v1" } }, "/apis/v1/tikhub/douyin/xingtu/kol_conversion_ability_analysis_v1": { "get": { "description": "Douyin (xingtu). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get kol Conversion Ability Analysis V1\n- The interface data is requested using an enterprise account, which is more expensive.\n\n### Parameters\n- kolId: User kolId, can be obtained from the following interfaces:\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_uid`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id`\n- _range: Time range, supports the following parameters:\n - _1 :Last 7 days\n - _2 :Last 30 days\n - _3 :Last 90 days\n\n### Return\n- kol Conversion Ability Analysis\n\nAPI references: `get_xingtu_kolid_by_sec_user_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_sec_user_id`); `get_xingtu_kolid_by_uid` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_uid` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_uid`); `get_xingtu_kolid_by_unique_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_unique_id`).\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_kol_conversion_ability_analysis_v1", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- kol Conversion Ability Analysis", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin kol_conversion_ability_analysis", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "1dfb5c43fd3b" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu/kol_conversion_ability_analysis_v1", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_kol_conversion_ability_analysis_v1", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu/kol_conversion_ability_analysis_v1" }, "parameters": [ { "name": "_range", "in": "query", "required": true, "schema": { "type": "string", "description": "Time range, supports the following parameters:\n - _1 :Last 7 days\n - _2 :Last 30 days\n - _3 :Last 90 days", "title": " Range" }, "description": "Time range, supports the following parameters:\n - _1 :Last 7 days\n - _2 :Last 30 days\n - _3 :Last 90 days", "example": "_1" }, { "name": "kolId", "in": "query", "required": true, "schema": { "type": "string", "description": "User kolId, can be obtained from the following interfaces:\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_uid`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id`\n\nAPI references: `get_xingtu_kolid_by_sec_user_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_sec_user_id`); `get_xingtu_kolid_by_uid` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_uid` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_uid`); `get_xingtu_kolid_by_unique_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_unique_id`).", "title": "Kolid" }, "description": "User kolId, can be obtained from the following interfaces:\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_uid`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id`\n\nAPI references: `get_xingtu_kolid_by_sec_user_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_sec_user_id`); `get_xingtu_kolid_by_uid` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_uid` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_uid`); `get_xingtu_kolid_by_unique_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_unique_id`).", "example": "7048929565493690398" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e8e4aa41b122f1b85492ae45a24bd4563805e0954ad8a87e67b8af8f9f0405d9" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/xingtu/kol_conversion_ability_analysis_v1?_range=_1&kolId=7048929565493690398' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu-kol_conversion_ability_analysis_v1" } }, "/apis/v1/tikhub/douyin/xingtu/kol_convert_video_display_v1": { "get": { "description": "Douyin (xingtu). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get kol Convert Video Display V1\n- The interface data is requested using an enterprise account, which is more expensive.\n\n### Parameters\n- kolId: User kolId, can be obtained from the following interfaces:\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_uid`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id`\n- detailType: Detail type, supports the following parameters:\n - _1 :Video Data\n - _2 :Product Data\n- page: Page number, starting from 1\n\n### Return\n- kol Convert Video Display\n\nAPI references: `get_xingtu_kolid_by_sec_user_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_sec_user_id`); `get_xingtu_kolid_by_uid` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_uid` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_uid`); `get_xingtu_kolid_by_unique_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_unique_id`).\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_kol_convert_video_display_v1", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- kol Convert Video Display", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin kol_convert_video_display", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "0824829957c5" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu/kol_convert_video_display_v1", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_kol_convert_video_display_v1", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu/kol_convert_video_display_v1" }, "parameters": [ { "name": "detailType", "in": "query", "required": true, "schema": { "type": "string", "description": "Detail type, supports the following parameters:\n - _1 :Video Data\n - _2 :Product Data", "title": "Detailtype" }, "description": "Detail type, supports the following parameters:\n - _1 :Video Data\n - _2 :Product Data", "example": "_1" }, { "name": "kolId", "in": "query", "required": true, "schema": { "type": "string", "description": "User kolId, can be obtained from the following interfaces:\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_uid`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id`\n\nAPI references: `get_xingtu_kolid_by_sec_user_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_sec_user_id`); `get_xingtu_kolid_by_uid` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_uid` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_uid`); `get_xingtu_kolid_by_unique_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_unique_id`).", "title": "Kolid" }, "description": "User kolId, can be obtained from the following interfaces:\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_uid`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id`\n\nAPI references: `get_xingtu_kolid_by_sec_user_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_sec_user_id`); `get_xingtu_kolid_by_uid` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_uid` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_uid`); `get_xingtu_kolid_by_unique_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_unique_id`).", "example": "7048929565493690398" }, { "name": "page", "in": "query", "required": true, "schema": { "type": "integer", "description": "Page number, starting from 1", "title": "Page" }, "description": "Page number, starting from 1", "example": 1 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:d93e37d2f1489fa3742ebe7fb7d9eeff998f2ad1589cdd4b8d813ad44ce2923f" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/xingtu/kol_convert_video_display_v1?detailType=_1&kolId=7048929565493690398&page=1' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu-kol_convert_video_display_v1" } }, "/apis/v1/tikhub/douyin/xingtu/kol_cp_info_v1": { "get": { "description": "Douyin (xingtu). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get kol Cp Info V1\n- The interface data is requested using an enterprise account, which is more expensive.\n\n### Parameters\n- kolId: User kolId, can be obtained from the following interfaces:\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_uid`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id`\n\n### Return\n- kol Cp Info\n\nAPI references: `get_xingtu_kolid_by_sec_user_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_sec_user_id`); `get_xingtu_kolid_by_uid` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_uid` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_uid`); `get_xingtu_kolid_by_unique_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_unique_id`).\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_kol_cp_info_v1", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- kol Cp Info", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin kol_cp_info", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "93157fa66201" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu/kol_cp_info_v1", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_kol_cp_info_v1", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu/kol_cp_info_v1" }, "parameters": [ { "name": "kolId", "in": "query", "required": true, "schema": { "type": "string", "description": "User kolId, can be obtained from the following interfaces:\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_uid`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id`\n\nAPI references: `get_xingtu_kolid_by_sec_user_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_sec_user_id`); `get_xingtu_kolid_by_uid` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_uid` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_uid`); `get_xingtu_kolid_by_unique_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_unique_id`).", "title": "Kolid" }, "description": "User kolId, can be obtained from the following interfaces:\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_uid`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id`\n\nAPI references: `get_xingtu_kolid_by_sec_user_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_sec_user_id`); `get_xingtu_kolid_by_uid` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_uid` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_uid`); `get_xingtu_kolid_by_unique_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_unique_id`).", "example": "7048929565493690398" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:9b1ad1cf3866264743de732fdc14dca173152be957dd2ba04fcb0ec1ef8c76f0" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/xingtu/kol_cp_info_v1?kolId=7048929565493690398' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu-kol_cp_info_v1" } }, "/apis/v1/tikhub/douyin/xingtu/kol_daily_fans_v1": { "get": { "description": "Douyin (xingtu). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get kol Daily Fans V1\n- The interface data is requested using an enterprise account, which is more expensive.\n\n### Parameters\n- kolId: User kolId, can be obtained from the following interfaces:\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_uid`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id`\n- startDate: Start date, format: yyyy-MM-dd\n- endDate: End date, format: yyyy-MM-dd\n\n### Return\n- kol Daily Fans\n\nAPI references: `get_xingtu_kolid_by_sec_user_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_sec_user_id`); `get_xingtu_kolid_by_uid` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_uid` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_uid`); `get_xingtu_kolid_by_unique_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_unique_id`).\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_kol_daily_fans_v1", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- kol Daily Fans", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin kol_daily_fans", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "8e98dda6be7e" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu/kol_daily_fans_v1", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_kol_daily_fans_v1", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu/kol_daily_fans_v1" }, "parameters": [ { "name": "endDate", "in": "query", "required": true, "schema": { "type": "string", "description": "End Date", "title": "Enddate" }, "description": "End Date", "example": "2025-01-01" }, { "name": "kolId", "in": "query", "required": true, "schema": { "type": "string", "description": "User kolId, can be obtained from the following interfaces:\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_uid`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id`\n\nAPI references: `get_xingtu_kolid_by_sec_user_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_sec_user_id`); `get_xingtu_kolid_by_uid` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_uid` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_uid`); `get_xingtu_kolid_by_unique_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_unique_id`).", "title": "Kolid" }, "description": "User kolId, can be obtained from the following interfaces:\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_uid`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id`\n\nAPI references: `get_xingtu_kolid_by_sec_user_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_sec_user_id`); `get_xingtu_kolid_by_uid` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_uid` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_uid`); `get_xingtu_kolid_by_unique_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_unique_id`).", "example": "7048929565493690398" }, { "name": "startDate", "in": "query", "required": true, "schema": { "type": "string", "description": "Start date", "title": "Startdate" }, "description": "Start date", "example": "2024-12-01" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:f9612b718b7ab575ce82840491f0704635dd346a5c6497999c3d261c53c655df" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/xingtu/kol_daily_fans_v1?endDate=2025-01-01&kolId=7048929565493690398&startDate=2024-12-01' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu-kol_daily_fans_v1" } }, "/apis/v1/tikhub/douyin/xingtu/kol_data_overview_v1": { "get": { "description": "Douyin (xingtu). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get kol Data Overview V1\n- The interface data is requested using an enterprise account, which is more expensive.\n\n### Parameters\n- kolId: User kolId, can be obtained from the following interfaces:\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_uid`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id`\n- _type: Type, supports the following parameters:\n - _1 :Personal Video\n - _2 :Xingtu Video\n- _range: Range, supports the following parameters:\n - _2 :Last 30 days\n - _3 :Last 90 days\n- flowType: Flow Type, supports the following parameters:\n - 1 : Default\n- onlyAssign (optional): Whether assigned, the specific parameters are as follows:\n - Not provided : Use API default behavior\n - false : All data\n - true : Only assigned data\n\n### Return\n- kol Data Overview\n\nAPI references: `get_xingtu_kolid_by_sec_user_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_sec_user_id`); `get_xingtu_kolid_by_uid` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_uid` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_uid`); `get_xingtu_kolid_by_unique_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_unique_id`).\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_kol_data_overview_v1", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- kol Data Overview", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin kol_data_overview", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "d72b8f47ecfc" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu/kol_data_overview_v1", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_kol_data_overview_v1", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu/kol_data_overview_v1" }, "parameters": [ { "name": "_range", "in": "query", "required": true, "schema": { "type": "string", "description": "Range, supports the following parameters:\n - _2 :Last 30 days\n - _3 :Last 90 days", "title": " Range" }, "description": "Range, supports the following parameters:\n - _2 :Last 30 days\n - _3 :Last 90 days", "example": "_2" }, { "name": "_type", "in": "query", "required": true, "schema": { "type": "string", "description": "Type, supports the following parameters:\n - _1 :Personal Video\n - _2 :Xingtu Video", "title": " Type" }, "description": "Type, supports the following parameters:\n - _1 :Personal Video\n - _2 :Xingtu Video", "example": "_1" }, { "name": "flowType", "in": "query", "required": true, "schema": { "type": "integer", "description": "Flow Type, supports the following parameters:\n - 1 : Default", "title": "Flowtype" }, "description": "Flow Type, supports the following parameters:\n - 1 : Default", "example": 1 }, { "name": "kolId", "in": "query", "required": true, "schema": { "type": "string", "description": "User kolId, can be obtained from the following interfaces:\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_uid`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id`\n\nAPI references: `get_xingtu_kolid_by_sec_user_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_sec_user_id`); `get_xingtu_kolid_by_uid` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_uid` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_uid`); `get_xingtu_kolid_by_unique_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_unique_id`).", "title": "Kolid" }, "description": "User kolId, can be obtained from the following interfaces:\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_uid`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id`\n\nAPI references: `get_xingtu_kolid_by_sec_user_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_sec_user_id`); `get_xingtu_kolid_by_uid` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_uid` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_uid`); `get_xingtu_kolid_by_unique_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_unique_id`).", "example": "7048929565493690398" }, { "name": "onlyAssign", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether assigned (optional)", "title": "Onlyassign" }, "description": "Whether assigned (optional)" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:5ecafb2b475128011754608f10a8efa4513ca1fe8343aa558f4a9ef22febca22" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/xingtu/kol_data_overview_v1?_range=_2&_type=_1&flowType=1&kolId=7048929565493690398' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu-kol_data_overview_v1" } }, "/apis/v1/tikhub/douyin/xingtu/kol_fans_portrait_v1": { "get": { "description": "Douyin (xingtu). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get kol Fans Portrait V1\n- The interface data is requested using an enterprise account, which is more expensive.\n\n### Parameters\n- kolId: User kolId, can be obtained from the following interfaces:\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_uid`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id`\n- fansType: Fans Type, supports the following parameters:\n - _1: Fans Portrait - Default\n - _2: Fans Group Portrait\n - _5: Iron Fans Portrait\n\n### Return\n- kol Fans Portrait\n\nAPI references: `get_xingtu_kolid_by_sec_user_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_sec_user_id`); `get_xingtu_kolid_by_uid` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_uid` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_uid`); `get_xingtu_kolid_by_unique_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_unique_id`).\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_kol_fans_portrait_v1", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- kol Fans Portrait", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin kol_fans_portrait", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "66021d48de86" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu/kol_fans_portrait_v1", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_kol_fans_portrait_v1", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu/kol_fans_portrait_v1" }, "parameters": [ { "name": "fansType", "in": "query", "required": false, "schema": { "type": "string", "description": "Fans Type, supports the following parameters:\n - _1: Fans Portrait - Default\n - _2: Fans Group Portrait\n - _5: Iron Fans Portrait", "default": "_1", "title": "Fanstype" }, "description": "Fans Type, supports the following parameters:\n - _1: Fans Portrait - Default\n - _2: Fans Group Portrait\n - _5: Iron Fans Portrait", "example": "_1" }, { "name": "kolId", "in": "query", "required": true, "schema": { "type": "string", "description": "User kolId, can be obtained from the following interfaces:\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_uid`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id`\n\nAPI references: `get_xingtu_kolid_by_sec_user_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_sec_user_id`); `get_xingtu_kolid_by_uid` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_uid` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_uid`); `get_xingtu_kolid_by_unique_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_unique_id`).", "title": "Kolid" }, "description": "User kolId, can be obtained from the following interfaces:\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_uid`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id`\n\nAPI references: `get_xingtu_kolid_by_sec_user_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_sec_user_id`); `get_xingtu_kolid_by_uid` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_uid` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_uid`); `get_xingtu_kolid_by_unique_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_unique_id`).", "example": "7048929565493690398" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:93ebce9e482ff9aef03441620985cfa0f65c812d276de2b53f07e9d24262be07" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/xingtu/kol_fans_portrait_v1?fansType=_1&kolId=7048929565493690398' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu-kol_fans_portrait_v1" } }, "/apis/v1/tikhub/douyin/xingtu/kol_link_struct_v1": { "get": { "description": "Douyin (xingtu). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get kol Link Struct V1\n- The interface data is requested using an enterprise account, which is more expensive.\n\n### Parameters\n- kolId: User kolId, can be obtained from the following interfaces:\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_uid`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id`\n\n### Return\n- kol Link Struct\n\nAPI references: `get_xingtu_kolid_by_sec_user_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_sec_user_id`); `get_xingtu_kolid_by_uid` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_uid` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_uid`); `get_xingtu_kolid_by_unique_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_unique_id`).\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_kol_link_struct_v1", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- kol Link Struct", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin kol_link_struct", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "fa2fe91a0908" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu/kol_link_struct_v1", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_kol_link_struct_v1", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu/kol_link_struct_v1" }, "parameters": [ { "name": "kolId", "in": "query", "required": true, "schema": { "type": "string", "description": "User kolId, can be obtained from the following interfaces:\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_uid`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id`\n\nAPI references: `get_xingtu_kolid_by_sec_user_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_sec_user_id`); `get_xingtu_kolid_by_uid` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_uid` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_uid`); `get_xingtu_kolid_by_unique_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_unique_id`).", "title": "Kolid" }, "description": "User kolId, can be obtained from the following interfaces:\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_uid`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id`\n\nAPI references: `get_xingtu_kolid_by_sec_user_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_sec_user_id`); `get_xingtu_kolid_by_uid` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_uid` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_uid`); `get_xingtu_kolid_by_unique_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_unique_id`).", "example": "7048929565493690398" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:1073039071f1ac45504f5d8bcbe00edf590c33a2339ae081bb94e5bfea4155c8" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/xingtu/kol_link_struct_v1?kolId=7048929565493690398' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu-kol_link_struct_v1" } }, "/apis/v1/tikhub/douyin/xingtu/kol_rec_videos_v1": { "get": { "description": "Douyin (xingtu). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get kol Rec Videos V1\n- The interface data is requested using an enterprise account, which is more expensive.\n\n### Parameters\n- kolId: User kolId, can be obtained from the following interfaces:\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_uid`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id`\n\n### Return\n- kol Rec Videos\n\nAPI references: `get_xingtu_kolid_by_sec_user_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_sec_user_id`); `get_xingtu_kolid_by_uid` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_uid` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_uid`); `get_xingtu_kolid_by_unique_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_unique_id`).\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_kol_rec_videos_v1", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- kol Rec Videos", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin kol_rec_videos", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "afb53a409b28" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu/kol_rec_videos_v1", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_kol_rec_videos_v1", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu/kol_rec_videos_v1" }, "parameters": [ { "name": "kolId", "in": "query", "required": true, "schema": { "type": "string", "description": "User kolId, can be obtained from the following interfaces:\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_uid`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id`\n\nAPI references: `get_xingtu_kolid_by_sec_user_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_sec_user_id`); `get_xingtu_kolid_by_uid` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_uid` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_uid`); `get_xingtu_kolid_by_unique_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_unique_id`).", "title": "Kolid" }, "description": "User kolId, can be obtained from the following interfaces:\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_uid`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id`\n\nAPI references: `get_xingtu_kolid_by_sec_user_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_sec_user_id`); `get_xingtu_kolid_by_uid` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_uid` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_uid`); `get_xingtu_kolid_by_unique_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_unique_id`).", "example": "7048929565493690398" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:0ee69af7a4ad3eea0ccc504207f1fc921319fefaec3b35bd76ad27d136a29408" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/xingtu/kol_rec_videos_v1?kolId=7048929565493690398' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu-kol_rec_videos_v1" } }, "/apis/v1/tikhub/douyin/xingtu/kol_service_price_v1": { "get": { "description": "Douyin (xingtu). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get kol Service Price V1\n- The interface data is requested using an enterprise account, which is more expensive.\n\n### Parameters\n- kolId: User kolId, can be obtained from the following interfaces:\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_uid`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id`\n- platformChannel:\n - Platform channel, supports the following parameters:\n - _1: Douyin Video\n - _10: Douyin Live\n\n### Return\n- kol Service Price\n\nAPI references: `get_xingtu_kolid_by_sec_user_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_sec_user_id`); `get_xingtu_kolid_by_uid` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_uid` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_uid`); `get_xingtu_kolid_by_unique_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_unique_id`).\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_kol_service_price_v1", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- kol Service Price", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin kol_service_price", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "67623f2fa2a7" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu/kol_service_price_v1", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_kol_service_price_v1", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu/kol_service_price_v1" }, "parameters": [ { "name": "kolId", "in": "query", "required": true, "schema": { "type": "string", "description": "User kolId, can be obtained from the following interfaces:\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_uid`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id`\n\nAPI references: `get_xingtu_kolid_by_sec_user_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_sec_user_id`); `get_xingtu_kolid_by_uid` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_uid` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_uid`); `get_xingtu_kolid_by_unique_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_unique_id`).", "title": "Kolid" }, "description": "User kolId, can be obtained from the following interfaces:\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_uid`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id`\n\nAPI references: `get_xingtu_kolid_by_sec_user_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_sec_user_id`); `get_xingtu_kolid_by_uid` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_uid` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_uid`); `get_xingtu_kolid_by_unique_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_unique_id`).", "example": "7048929565493690398" }, { "name": "platformChannel", "in": "query", "required": true, "schema": { "type": "string", "description": "- Platform channel, supports the following parameters:\n - _1: Douyin Video\n - _10: Douyin Live", "title": "Platformchannel" }, "description": "- Platform channel, supports the following parameters:\n - _1: Douyin Video\n - _10: Douyin Live", "example": "_1" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:920b52d73151cdfe52fb96157b637407c48d7167ffadce58d07927e7c92540bf" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/xingtu/kol_service_price_v1?kolId=7048929565493690398&platformChannel=_1' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu-kol_service_price_v1" } }, "/apis/v1/tikhub/douyin/xingtu/kol_touch_distribution_v1": { "get": { "description": "Douyin (xingtu). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get kol Touch Distribution V1\n- The interface data is requested using an enterprise account, which is more expensive.\n\n### Parameters\n- kolId: User kolId, can be obtained from the following interfaces:\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_uid`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id`\n\n### Return\n- kol Touch Distribution\n\nAPI references: `get_xingtu_kolid_by_sec_user_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_sec_user_id`); `get_xingtu_kolid_by_uid` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_uid` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_uid`); `get_xingtu_kolid_by_unique_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_unique_id`).\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_kol_touch_distribution_v1", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- kol Touch Distribution", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin kol_touch_distribution", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "5e15ddc5d91a" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu/kol_touch_distribution_v1", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_kol_touch_distribution_v1", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu/kol_touch_distribution_v1" }, "parameters": [ { "name": "kolId", "in": "query", "required": true, "schema": { "type": "string", "description": "User kolId, can be obtained from the following interfaces:\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_uid`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id`\n\nAPI references: `get_xingtu_kolid_by_sec_user_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_sec_user_id`); `get_xingtu_kolid_by_uid` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_uid` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_uid`); `get_xingtu_kolid_by_unique_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_unique_id`).", "title": "Kolid" }, "description": "User kolId, can be obtained from the following interfaces:\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_uid`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id`\n\nAPI references: `get_xingtu_kolid_by_sec_user_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_sec_user_id`); `get_xingtu_kolid_by_uid` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_uid` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_uid`); `get_xingtu_kolid_by_unique_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_unique_id`).", "example": "7048929565493690398" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:35353cd0d831094e43e368642030a2afd55ae1c70c509fd9bc635056afd27be1" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/xingtu/kol_touch_distribution_v1?kolId=7048929565493690398' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu-kol_touch_distribution_v1" } }, "/apis/v1/tikhub/douyin/xingtu/kol_video_performance_v1": { "get": { "description": "Douyin (xingtu). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get kol Video Performance V1\n- The interface data is requested using an enterprise account, which is more expensive.\n\n### Parameters\n- kolId: User kolId, can be obtained from the following interfaces:\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_uid`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id`\n- onlyAssign: Whether to display only assigned works, the specific parameters are as follows:\n - false : Show all, including personal works and assigned works, default value.\n - true : Only display assigned works from XingTu.\n\n### Return\n- kol Video Performance\n\nAPI references: `get_xingtu_kolid_by_sec_user_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_sec_user_id`); `get_xingtu_kolid_by_uid` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_uid` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_uid`); `get_xingtu_kolid_by_unique_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_unique_id`).\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_kol_video_performance_v1", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- kol Video Performance", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin kol_video_performance", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "c858cb912979" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu/kol_video_performance_v1", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_kol_video_performance_v1", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu/kol_video_performance_v1" }, "parameters": [ { "name": "kolId", "in": "query", "required": true, "schema": { "type": "string", "description": "User kolId, can be obtained from the following interfaces:\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_uid`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id`\n\nAPI references: `get_xingtu_kolid_by_sec_user_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_sec_user_id`); `get_xingtu_kolid_by_uid` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_uid` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_uid`); `get_xingtu_kolid_by_unique_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_unique_id`).", "title": "Kolid" }, "description": "User kolId, can be obtained from the following interfaces:\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_uid`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id`\n\nAPI references: `get_xingtu_kolid_by_sec_user_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_sec_user_id`); `get_xingtu_kolid_by_uid` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_uid` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_uid`); `get_xingtu_kolid_by_unique_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_unique_id`).", "example": "7048929565493690398" }, { "name": "onlyAssign", "in": "query", "required": true, "schema": { "type": "boolean", "description": "Whether to display only assigned works, the specific parameters are as follows:\n - false : Show all, including personal works and assigned works, default value.\n - true : Only display assigned works from XingTu.", "title": "Onlyassign" }, "description": "Whether to display only assigned works, the specific parameters are as follows:\n - false : Show all, including personal works and assigned works, default value.\n - true : Only display assigned works from XingTu.", "example": false } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:d2e971b944cb69db1feee50f44e213cf4d337e083bc09f364c85ce3f79b3279a" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/xingtu/kol_video_performance_v1?kolId=7048929565493690398&onlyAssign=false' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu-kol_video_performance_v1" } }, "/apis/v1/tikhub/douyin/xingtu/kol_xingtu_index_v1": { "get": { "description": "Douyin (xingtu). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get kol Xingtu Index V1\n- The interface data is requested using an enterprise account, which is more expensive.\n\n### Parameters\n- kolId: User kolId, can be obtained from the following interfaces:\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_uid`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id`\n\n### Return\n- kol Xingtu Index\n\nAPI references: `get_xingtu_kolid_by_sec_user_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_sec_user_id`); `get_xingtu_kolid_by_uid` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_uid` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_uid`); `get_xingtu_kolid_by_unique_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_unique_id`).\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_kol_xingtu_index_v1", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- kol Xingtu Index", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin kol_xingtu_index", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "222a524777e6" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu/kol_xingtu_index_v1", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_kol_xingtu_index_v1", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu/kol_xingtu_index_v1" }, "parameters": [ { "name": "kolId", "in": "query", "required": true, "schema": { "type": "string", "description": "User kolId, can be obtained from the following interfaces:\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_uid`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id`\n\nAPI references: `get_xingtu_kolid_by_sec_user_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_sec_user_id`); `get_xingtu_kolid_by_uid` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_uid` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_uid`); `get_xingtu_kolid_by_unique_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_unique_id`).", "title": "Kolid" }, "description": "User kolId, can be obtained from the following interfaces:\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_uid`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id`\n - `/tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id`\n\nAPI references: `get_xingtu_kolid_by_sec_user_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_sec_user_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_sec_user_id`); `get_xingtu_kolid_by_uid` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_uid` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_uid`); `get_xingtu_kolid_by_unique_id` = `GET /tikhub/douyin/xingtu/get_xingtu_kolid_by_unique_id` (operationId: `get_tikhub_douyin_xingtu_get_xingtu_kolid_by_unique_id`).", "example": "7048929565493690398" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:666f5b04fa6fa67cffdd839346ac9c0d8feaf948cb33f9b993fc216a189753d3" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/xingtu/kol_xingtu_index_v1?kolId=7048929565493690398' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu-kol_xingtu_index_v1" } }, "/apis/v1/tikhub/douyin/xingtu/search_kol_v2": { "get": { "description": "Douyin (xingtu). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Advanced Search Kol V2, supports follower range and content tag filtering\n- The interface data is requested using an enterprise account, which is more expensive.\n\n### Parameters\n- keyword: Keyword\n- followerRange (optional): Follower range, format: min-max\n - Example: 10-100 indicates follower range between 100,000 and 1,000,000\n - Do not pass this parameter to not limit the follower range\n- contentTag (optional): Content tag, supports the following formats:\n - tag-{id}: First-level tag, e.g., tag-1 (Beauty)\n - tag_level_two-{id}: Second-level tag, e.g., tag_level_two-7 (Outfit)\n - Refer to the contentTag mapping table in the documentation\n - Do not pass this parameter to not limit content tags\n\n### Return\n- Kol List (with advanced filtering)\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_search_kol_v2", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Kol List (with advanced filtering)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin search_kol", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "f0db5427cec3" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu/search_kol_v2", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_search_kol_v2", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu/search_kol_v2" }, "parameters": [ { "name": "contentTag", "in": "query", "required": false, "schema": { "type": "string", "description": "Content Tag (optional), e.g. tag-1 or tag_level_two-7", "title": "Contenttag" }, "description": "Content Tag (optional), e.g. tag-1 or tag_level_two-7", "example": "tag-1" }, { "name": "followerRange", "in": "query", "required": false, "schema": { "type": "string", "description": "Follower Range (optional), e.g. 10-100 means 100K-1M followers", "title": "Followerrange" }, "description": "Follower Range (optional), e.g. 10-100 means 100K-1M followers", "example": "10-100" }, { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Keyword", "title": "Keyword" }, "description": "Keyword", "example": "Beauty" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:338fec906395024d6f61c33098f671b41543c850067dd833bdef7b7484258df9" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/xingtu/search_kol_v2?contentTag=tag-1&followerRange=10-100&keyword=Beauty' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu-search_kol_v2" } }, "/apis/v1/tikhub/douyin/xingtu_v2/get_author_audience_distribution": { "get": { "description": "Douyin (xingtu_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get creator audience profile distribution\n\n### Parameters\n- o_author_id: Creator ID\n- platform_source: Platform source, default 1\n- platform_channel: Platform channel, default 1\n- link_type: Audience profile link type, required; example: `5`. Omitting it prevents valid profile data from being returned\n\n### Return\n- Audience distribution data\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_v2_get_author_audience_distribution", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Audience distribution data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_author_audience_distribution", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "55996c4c6d96" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu_v2/get_author_audience_distribution", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_v2_get_author_audience_distribution", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu_v2/get_author_audience_distribution" }, "parameters": [ { "name": "link_type", "in": "query", "required": true, "schema": { "type": "integer", "description": "Audience profile link type, required; example: `5`. Omitting it prevents valid profile data from being returned", "title": "Link Type" }, "description": "Audience profile link type, required; example: `5`. Omitting it prevents valid profile data from being returned", "example": 5 }, { "name": "o_author_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Creator ID", "title": "O Author Id" }, "description": "Creator ID", "example": "7029342444797820939" }, { "name": "platform_channel", "in": "query", "required": false, "schema": { "type": "integer", "description": "Platform channel, default 1", "default": 1, "title": "Platform Channel" }, "description": "Platform channel, default 1", "example": 1 }, { "name": "platform_source", "in": "query", "required": false, "schema": { "type": "integer", "description": "Platform source, default 1", "default": 1, "title": "Platform Source" }, "description": "Platform source, default 1", "example": 1 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:0c2196c6db9725ac9537f0c96ada3d8debf96801e65560c9c5dc65fd9b05be20" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/xingtu_v2/get_author_audience_distribution?link_type=5&o_author_id=7029342444797820939&platform_channel=1&platform_source=1' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu_v2-get_author_audience_distribution" } }, "/apis/v1/tikhub/douyin/xingtu_v2/get_author_base_info": { "get": { "description": "Douyin (xingtu_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get creator/author base information\n\n### Parameters\n- o_author_id: Creator/author ID\n- platform_source: Platform source, default 1\n- platform_channel: Platform channel, default 1\n- recommend: Whether to return recommendation info, default True\n- need_sec_uid: Whether to return sec_uid, default True\n- need_linkage_info: Whether to return linkage info, default True\n\n### Return\n- Creator base info data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_v2_get_author_base_info", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Creator base info data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_author_base_info", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "d0ba134d6aa3" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu_v2/get_author_base_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_v2_get_author_base_info", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu_v2/get_author_base_info" }, "parameters": [ { "name": "need_linkage_info", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether to return linkage info", "default": true, "title": "Need Linkage Info" }, "description": "Whether to return linkage info", "example": true }, { "name": "need_sec_uid", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether to return sec_uid", "default": true, "title": "Need Sec Uid" }, "description": "Whether to return sec_uid", "example": true }, { "name": "o_author_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Creator author ID", "title": "O Author Id" }, "description": "Creator author ID", "example": "7589271892177518598" }, { "name": "platform_channel", "in": "query", "required": false, "schema": { "type": "integer", "description": "Platform channel, default 1", "default": 1, "title": "Platform Channel" }, "description": "Platform channel, default 1", "example": 1 }, { "name": "platform_source", "in": "query", "required": false, "schema": { "type": "integer", "description": "Platform source, default 1", "default": 1, "title": "Platform Source" }, "description": "Platform source, default 1", "example": 1 }, { "name": "recommend", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether to return recommendation info", "default": true, "title": "Recommend" }, "description": "Whether to return recommendation info", "example": true } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:9e53e0ee7459edc91751421f5547b9a33f9a993ecae972f724153fcc2b78f1e2" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/xingtu_v2/get_author_base_info?need_linkage_info=true&need_sec_uid=true&o_author_id=7589271892177518598&platform_channel=1&platform_source=1&recommend=true' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu_v2-get_author_base_info" } }, "/apis/v1/tikhub/douyin/xingtu_v2/get_author_business_card_info": { "get": { "description": "Douyin (xingtu_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get creator/author business card information\n\n### Parameters\n- o_author_id: Creator/author ID\n\n### Return\n- Creator business card info data\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_v2_get_author_business_card_info", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Creator business card info data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_author_business_card_info", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "5ff455244f5b" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu_v2/get_author_business_card_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_v2_get_author_business_card_info", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu_v2/get_author_business_card_info" }, "parameters": [ { "name": "o_author_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Creator author ID", "title": "O Author Id" }, "description": "Creator author ID", "example": "7589271892177518598" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e3523b970f85fb60fd9ed0794c86199ba87cbf75764a76959ef774ccaa6554c1" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/xingtu_v2/get_author_business_card_info?o_author_id=7589271892177518598' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu_v2-get_author_business_card_info" } }, "/apis/v1/tikhub/douyin/xingtu_v2/get_author_commerce_spread_info": { "get": { "description": "Douyin (xingtu_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get cost-effectiveness and performance estimates for a creator's short-video collaborations, including CPM and CPE\n- Supports evaluation of content performance with marketing traffic excluded\n\n### Parameters\n- o_author_id: Creator ID\n\n### Return\n- Product-placement video: `cpm_20_60`, `cpe_20_60`\n- Custom video: `cpm_60`, `cpe_60`\n- Other estimated commerce-spread performance data\n\n\nPublished reference price: $0.003 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_v2_get_author_commerce_spread_info", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Product-placement video: `cpm_20_60`, `cpe_20_60`\n- Custom video: `cpm_60`, `cpe_60`\n- Other estimated commerce-spread performance data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_author_commerce_spread_info", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.003, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "77d57cefc8ac" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu_v2/get_author_commerce_spread_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_v2_get_author_commerce_spread_info", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu_v2/get_author_commerce_spread_info" }, "parameters": [ { "name": "o_author_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Creator ID", "title": "O Author Id" }, "description": "Creator ID", "example": "7112600044674482187" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:fbc5ad6431db0d6ab962239a7c1cf3573336e3c2e7699f78f02e8cb8d08d3c09" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/xingtu_v2/get_author_commerce_spread_info?o_author_id=7112600044674482187' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu_v2-get_author_commerce_spread_info" } }, "/apis/v1/tikhub/douyin/xingtu_v2/get_author_content_hot_keywords": { "get": { "description": "Douyin (xingtu_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get creator/author content hot keywords\n\n### Parameters\n- author_id: Creator/author ID\n- keyword_type: Keyword type, default 0\n\n### Return\n- Creator content hot keywords data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_v2_get_author_content_hot_keywords", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Creator content hot keywords data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_author_content_hot_keywords", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "fcb8e32e3a92" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu_v2/get_author_content_hot_keywords", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_v2_get_author_content_hot_keywords", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu_v2/get_author_content_hot_keywords" }, "parameters": [ { "name": "author_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Creator author ID", "title": "Author Id" }, "description": "Creator author ID", "example": "7589271892177518598" }, { "name": "keyword_type", "in": "query", "required": false, "schema": { "type": "integer", "description": "Keyword type, default 0", "default": 0, "title": "Keyword Type" }, "description": "Keyword type, default 0", "example": 0 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:dc91230e270c677f2162f9c8fe9fc42137080107d7704588ba9be9f48f29b0b0" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/xingtu_v2/get_author_content_hot_keywords?author_id=7589271892177518598&keyword_type=0' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu_v2-get_author_content_hot_keywords" } }, "/apis/v1/tikhub/douyin/xingtu_v2/get_author_convert_ability": { "get": { "description": "Douyin (xingtu_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get creator conversion ability data (GMV, clicks, conversion-rate ranges)\n\n### Parameters\n- o_author_id: Creator ID\n- platform_source: Platform source, default 1\n- platform_channel: Platform channel, default 1\n- industry_id: Industry ID, 0=unlimited, default 0\n- time_range: Time range tier, default 2\n\n### Return\n- Conversion ability data\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_v2_get_author_convert_ability", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Conversion ability data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_author_convert_ability", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "b4ac361551b0" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu_v2/get_author_convert_ability", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_v2_get_author_convert_ability", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu_v2/get_author_convert_ability" }, "parameters": [ { "name": "industry_id", "in": "query", "required": false, "schema": { "type": "integer", "description": "Industry ID, 0=unlimited", "default": 0, "title": "Industry Id" }, "description": "Industry ID, 0=unlimited", "example": 0 }, { "name": "o_author_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Creator ID", "title": "O Author Id" }, "description": "Creator ID", "example": "7029342444797820939" }, { "name": "platform_channel", "in": "query", "required": false, "schema": { "type": "integer", "description": "Platform channel, default 1", "default": 1, "title": "Platform Channel" }, "description": "Platform channel, default 1", "example": 1 }, { "name": "platform_source", "in": "query", "required": false, "schema": { "type": "integer", "description": "Platform source, default 1", "default": 1, "title": "Platform Source" }, "description": "Platform source, default 1", "example": 1 }, { "name": "time_range", "in": "query", "required": false, "schema": { "type": "integer", "description": "Time range tier, default 2", "default": 2, "title": "Time Range" }, "description": "Time range tier, default 2", "example": 2 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:2053f5b8dc79f3d0066599172b3432dccf473264dae5724c6ec1aa4dc59e37a0" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/xingtu_v2/get_author_convert_ability?industry_id=0&o_author_id=7029342444797820939&platform_channel=1&platform_source=1&time_range=2' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu_v2-get_author_convert_ability" } }, "/apis/v1/tikhub/douyin/xingtu_v2/get_author_convert_videos_or_products": { "get": { "description": "Douyin (xingtu_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get creator conversion video/product details, with pagination\n\n### Parameters\n- o_author_id: Creator ID\n- platform_source: Platform source, default 1\n- platform_channel: Platform channel, default 1\n- detail_type: Detail type, 1=videos, 2=products, default 1\n- industry_id: Industry ID, 0=unlimited, default 0\n- time_range: Time range tier, default 2\n- page: Page number, default 1\n\n### Return\n- Conversion video/product detail data\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_v2_get_author_convert_videos_or_products", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Conversion video/product detail data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_author_convert_videos_or_products", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "c16b92926716" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu_v2/get_author_convert_videos_or_products", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_v2_get_author_convert_videos_or_products", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu_v2/get_author_convert_videos_or_products" }, "parameters": [ { "name": "detail_type", "in": "query", "required": false, "schema": { "type": "integer", "description": "Detail type: 1=related videos, 2=related products", "default": 1, "title": "Detail Type" }, "description": "Detail type: 1=related videos, 2=related products", "example": 1 }, { "name": "industry_id", "in": "query", "required": false, "schema": { "type": "integer", "description": "Industry ID, 0=unlimited", "default": 0, "title": "Industry Id" }, "description": "Industry ID, 0=unlimited", "example": 0 }, { "name": "o_author_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Creator ID", "title": "O Author Id" }, "description": "Creator ID", "example": "7589271892177518598" }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page number, default 1", "default": 1, "title": "Page" }, "description": "Page number, default 1", "example": 1 }, { "name": "platform_channel", "in": "query", "required": false, "schema": { "type": "integer", "description": "Platform channel, default 1", "default": 1, "title": "Platform Channel" }, "description": "Platform channel, default 1", "example": 1 }, { "name": "platform_source", "in": "query", "required": false, "schema": { "type": "integer", "description": "Platform source, default 1", "default": 1, "title": "Platform Source" }, "description": "Platform source, default 1", "example": 1 }, { "name": "time_range", "in": "query", "required": false, "schema": { "type": "integer", "description": "Time range tier, default 2", "default": 2, "title": "Time Range" }, "description": "Time range tier, default 2", "example": 2 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:78e6fb6deabf90812b471c3b0adee529428fc84b2b28a86abe09eb7ac8657992" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/xingtu_v2/get_author_convert_videos_or_products?detail_type=1&industry_id=0&o_author_id=7589271892177518598&page=1&platform_channel=1&platform_source=1&time_range=2' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu_v2-get_author_convert_videos_or_products" } }, "/apis/v1/tikhub/douyin/xingtu_v2/get_author_cp_info": { "get": { "description": "Douyin (xingtu_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get creator CP (cooperation) info\n\n### Parameters\n- o_author_id: Creator ID\n- platform_source: Platform source, default 1\n- platform_channel: Platform channel, default 1\n\n### Return\n- CP cooperation info data\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_v2_get_author_cp_info", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- CP cooperation info data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_author_cp_info", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "873cdea639af" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu_v2/get_author_cp_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_v2_get_author_cp_info", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu_v2/get_author_cp_info" }, "parameters": [ { "name": "o_author_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Creator ID", "title": "O Author Id" }, "description": "Creator ID", "example": "7029342444797820939" }, { "name": "platform_channel", "in": "query", "required": false, "schema": { "type": "integer", "description": "Platform channel, default 1", "default": 1, "title": "Platform Channel" }, "description": "Platform channel, default 1", "example": 1 }, { "name": "platform_source", "in": "query", "required": false, "schema": { "type": "integer", "description": "Platform source, default 1", "default": 1, "title": "Platform Source" }, "description": "Platform source, default 1", "example": 1 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:3cf9e8e2ea91a4e16692b04c901acdca7415352ba88146b1ec1ea77882e2e765" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/xingtu_v2/get_author_cp_info?o_author_id=7029342444797820939&platform_channel=1&platform_source=1' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu_v2-get_author_cp_info" } }, "/apis/v1/tikhub/douyin/xingtu_v2/get_author_daily_fans": { "get": { "description": "Douyin (xingtu_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get creator daily fans trend, with optional date range\n\n### Parameters\n- author_id: Creator ID\n- platform_source: Platform source, default 1\n- start_date: Start date, format YYYYMMDD, optional\n- end_date: End date, format YYYYMMDD, optional\n- author_type: Author type, optional\n\n### Return\n- Daily fans trend data (daily / delta, etc.)\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_v2_get_author_daily_fans", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Daily fans trend data (daily / delta, etc.)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_author_daily_fans", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "b101734581a4" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu_v2/get_author_daily_fans", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_v2_get_author_daily_fans", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu_v2/get_author_daily_fans" }, "parameters": [ { "name": "author_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Creator ID", "title": "Author Id" }, "description": "Creator ID", "example": "7029342444797820939" }, { "name": "author_type", "in": "query", "required": false, "schema": { "description": "Author type, optional", "title": "Author Type", "type": [ "integer", "null" ] }, "description": "Author type, optional" }, { "name": "end_date", "in": "query", "required": false, "schema": { "description": "End date, format YYYYMMDD, optional", "title": "End Date", "type": [ "string", "null" ] }, "description": "End date, format YYYYMMDD, optional" }, { "name": "platform_source", "in": "query", "required": false, "schema": { "type": "integer", "description": "Platform source, default 1", "default": 1, "title": "Platform Source" }, "description": "Platform source, default 1", "example": 1 }, { "name": "start_date", "in": "query", "required": false, "schema": { "description": "Start date, format YYYYMMDD, optional", "title": "Start Date", "type": [ "string", "null" ] }, "description": "Start date, format YYYYMMDD, optional" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:d57cbca4ed96ba3826f202a215b68824522d6c57279d3dbb62a9953f3eaedde1" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/xingtu_v2/get_author_daily_fans?author_id=7029342444797820939&platform_source=1' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu_v2-get_author_daily_fans" } }, "/apis/v1/tikhub/douyin/xingtu_v2/get_author_daily_link": { "get": { "description": "Douyin (xingtu_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get a creator's daily link-metric trend over a date range\n\n### Required\n- o_author_id, link_type, start_date, end_date\n\n### Return\n- Daily link-metric trend data\n\n\nPublished reference price: $0.003 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_v2_get_author_daily_link", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Daily link-metric trend data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_author_daily_link", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.003, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "902193c84ee2" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu_v2/get_author_daily_link", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_v2_get_author_daily_link", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu_v2/get_author_daily_link" }, "parameters": [ { "name": "end_date", "in": "query", "required": true, "schema": { "type": "string", "description": "End date, YYYYMMDD recommended", "title": "End Date" }, "description": "End date, YYYYMMDD recommended", "example": "20250822" }, { "name": "industry_id", "in": "query", "required": false, "schema": { "type": "integer", "description": "Industry ID, 0 for all", "default": 0, "title": "Industry Id" }, "description": "Industry ID, 0 for all" }, { "name": "link_type", "in": "query", "required": true, "schema": { "type": "integer", "description": "Xingtu link metric type ID", "title": "Link Type" }, "description": "Xingtu link metric type ID", "example": 5 }, { "name": "o_author_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Creator ID", "title": "O Author Id" }, "description": "Creator ID", "example": "7112600044674482187" }, { "name": "platform_channel", "in": "query", "required": false, "schema": { "type": "integer", "description": "Platform channel: 1 for short video", "default": 1, "title": "Platform Channel" }, "description": "Platform channel: 1 for short video" }, { "name": "platform_source", "in": "query", "required": false, "schema": { "type": "integer", "description": "Platform source: 1 for Douyin", "default": 1, "title": "Platform Source" }, "description": "Platform source: 1 for Douyin" }, { "name": "start_date", "in": "query", "required": true, "schema": { "type": "string", "description": "Start date, YYYYMMDD recommended", "title": "Start Date" }, "description": "Start date, YYYYMMDD recommended", "example": "20250801" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:30c4ca970ae21347d2ce72a682c9821ad010d77fc5c4ddddc4c35602d1b95c47" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/xingtu_v2/get_author_daily_link?end_date=20250822&link_type=5&o_author_id=7112600044674482187&start_date=20250801' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu_v2-get_author_daily_link" } }, "/apis/v1/tikhub/douyin/xingtu_v2/get_author_daily_link_score": { "get": { "description": "Douyin (xingtu_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get a creator's daily link-score trend over a date range\n\n### Required\n- o_author_id, link_score_type, start_date, end_date\n\n### Return\n- Daily link-score trend data\n\n\nPublished reference price: $0.003 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_v2_get_author_daily_link_score", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Daily link-score trend data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_author_daily_link_score", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.003, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "8b528b2a22d6" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu_v2/get_author_daily_link_score", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_v2_get_author_daily_link_score", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu_v2/get_author_daily_link_score" }, "parameters": [ { "name": "end_date", "in": "query", "required": true, "schema": { "type": "string", "description": "End date, YYYYMMDD recommended", "title": "End Date" }, "description": "End date, YYYYMMDD recommended", "example": "20250822" }, { "name": "industry_id", "in": "query", "required": false, "schema": { "type": "integer", "description": "Industry ID, 0 for all", "default": 0, "title": "Industry Id" }, "description": "Industry ID, 0 for all" }, { "name": "link_score_type", "in": "query", "required": true, "schema": { "type": "integer", "description": "Xingtu link-score type ID", "title": "Link Score Type" }, "description": "Xingtu link-score type ID", "example": 1 }, { "name": "o_author_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Creator ID", "title": "O Author Id" }, "description": "Creator ID", "example": "7112600044674482187" }, { "name": "platform_channel", "in": "query", "required": false, "schema": { "type": "integer", "description": "Platform channel: 1 for short video", "default": 1, "title": "Platform Channel" }, "description": "Platform channel: 1 for short video" }, { "name": "platform_source", "in": "query", "required": false, "schema": { "type": "integer", "description": "Platform source: 1 for Douyin", "default": 1, "title": "Platform Source" }, "description": "Platform source: 1 for Douyin" }, { "name": "start_date", "in": "query", "required": true, "schema": { "type": "string", "description": "Start date, YYYYMMDD recommended", "title": "Start Date" }, "description": "Start date, YYYYMMDD recommended", "example": "20250801" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:864f03eb07e6c5de1300f60a355d6b21ece32b39156ed93fa59148dccbaef935" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/xingtu_v2/get_author_daily_link_score?end_date=20250822&link_score_type=1&o_author_id=7112600044674482187&start_date=20250801' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu_v2-get_author_daily_link_score" } }, "/apis/v1/tikhub/douyin/xingtu_v2/get_author_fans_distribution": { "get": { "description": "Douyin (xingtu_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get creator fans profile distribution (gender, age, region, interests, etc.)\n\n### Parameters\n- o_author_id: Creator ID\n- platform_source: Platform source, default 1\n- platform_channel: Platform channel, default 1\n\n### Return\n- Fans distribution data (distributions: multi-dimension distribution array)\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_v2_get_author_fans_distribution", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Fans distribution data (distributions: multi-dimension distribution array)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_author_fans_distribution", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "887a14cca2a7" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu_v2/get_author_fans_distribution", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_v2_get_author_fans_distribution", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu_v2/get_author_fans_distribution" }, "parameters": [ { "name": "o_author_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Creator ID", "title": "O Author Id" }, "description": "Creator ID", "example": "7029342444797820939" }, { "name": "platform_channel", "in": "query", "required": false, "schema": { "type": "integer", "description": "Platform channel, default 1", "default": 1, "title": "Platform Channel" }, "description": "Platform channel, default 1", "example": 1 }, { "name": "platform_source", "in": "query", "required": false, "schema": { "type": "integer", "description": "Platform source, default 1", "default": 1, "title": "Platform Source" }, "description": "Platform source, default 1", "example": 1 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:53cd1998b74dd81cdc3f5b54b4ff9f8d1fc9308e1681ad0e018e8382e17596e5" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/xingtu_v2/get_author_fans_distribution?o_author_id=7029342444797820939&platform_channel=1&platform_source=1' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu_v2-get_author_fans_distribution" } }, "/apis/v1/tikhub/douyin/xingtu_v2/get_author_homepage_videos": { "get": { "description": "Douyin (xingtu_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get creator homepage video list with pagination, including interaction rate,\n finish rate and content theme labels per item\n- Can filter by star(sponsored) items and publish time range\n- Differs from `get_author_show_items`: paginated and filterable, returns total count\n\n### Parameters\n- o_author_id: Creator ID\n- page: Page number, default 1\n- is_star_item: 1=star items only, 0=non-star only, omit=all\n- start_time: Publish start time, unix seconds, optional\n- end_time: Publish end time, unix seconds, optional\n\n### Return\n- Video list data (items + pagination with total_count / has_more)\n\nAPI references: `get_author_show_items` = `GET /tikhub/douyin/xingtu_v2/get_author_show_items` (operationId: `get_tikhub_douyin_xingtu_v2_get_author_show_items`).\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_v2_get_author_homepage_videos", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Video list data (items + pagination with total_count / has_more)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_author_homepage_videos", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "389d9d242131" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu_v2/get_author_homepage_videos", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_v2_get_author_homepage_videos", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu_v2/get_author_homepage_videos" }, "parameters": [ { "name": "end_time", "in": "query", "required": false, "schema": { "description": "Post publish end time, Unix seconds", "title": "End Time", "type": [ "integer", "null" ] }, "description": "Post publish end time, Unix seconds" }, { "name": "is_star_item", "in": "query", "required": false, "schema": { "description": "1=star items only, 0=non-star only, omit=all", "title": "Is Star Item", "type": [ "integer", "null" ] }, "description": "1=star items only, 0=non-star only, omit=all" }, { "name": "o_author_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Creator ID", "title": "O Author Id" }, "description": "Creator ID", "example": "7029342444797820939" }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page number, default 1", "default": 1, "title": "Page" }, "description": "Page number, default 1", "example": 1 }, { "name": "start_time", "in": "query", "required": false, "schema": { "description": "Post publish start time, Unix seconds", "title": "Start Time", "type": [ "integer", "null" ] }, "description": "Post publish start time, Unix seconds" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:a5a0322ee2bd3cf86316846a1c9aeb4fc6c73529114885d21744b6adfc7d46ec" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/xingtu_v2/get_author_homepage_videos?o_author_id=7029342444797820939&page=1' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu_v2-get_author_homepage_videos" } }, "/apis/v1/tikhub/douyin/xingtu_v2/get_author_hot_comment_tokens": { "get": { "description": "Douyin (xingtu_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get creator/author hot comment tokens/keywords\n\n### Parameters\n- author_id: Creator/author ID\n- num: Number of hot tokens, default 10\n- without_emoji: Whether to exclude emoji, default True\n\n### Return\n- Creator hot comment tokens data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_v2_get_author_hot_comment_tokens", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Creator hot comment tokens data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_author_hot_comment_tokens", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "830bc20bce92" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu_v2/get_author_hot_comment_tokens", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_v2_get_author_hot_comment_tokens", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu_v2/get_author_hot_comment_tokens" }, "parameters": [ { "name": "author_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Creator author ID", "title": "Author Id" }, "description": "Creator author ID", "example": "7589271892177518598" }, { "name": "num", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number of hot tokens, default 10", "default": 10, "title": "Num" }, "description": "Number of hot tokens, default 10", "example": 10 }, { "name": "without_emoji", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether to exclude emoji", "default": true, "title": "Without Emoji" }, "description": "Whether to exclude emoji", "example": true } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:527772efe4c5092ab64bb67634b6213b575d629063961108deabad0cd2df142d" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/xingtu_v2/get_author_hot_comment_tokens?author_id=7589271892177518598&num=10&without_emoji=true' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu_v2-get_author_hot_comment_tokens" } }, "/apis/v1/tikhub/douyin/xingtu_v2/get_author_link_info": { "get": { "description": "Douyin (xingtu_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get creator Xingtu link indices (cooperation / CP / conversion / shopping index)\n\n### Parameters\n- o_author_id: Creator ID\n- platform_source: Platform source, default 1\n- platform_channel: Platform channel, default 1\n- industy_tag: Industry tag, 0=unlimited, default 0\n\n### Return\n- Link index data (cooperate_index / cp_index / link_convert_index / link_shopping_index)\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_v2_get_author_link_info", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Link index data (cooperate_index / cp_index / link_convert_index / link_shopping_index)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_author_link_info", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "6d2df27ae3ba" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu_v2/get_author_link_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_v2_get_author_link_info", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu_v2/get_author_link_info" }, "parameters": [ { "name": "industy_tag", "in": "query", "required": false, "schema": { "type": "integer", "description": "Industry tag, 0=unlimited", "default": 0, "title": "Industy Tag" }, "description": "Industry tag, 0=unlimited", "example": 0 }, { "name": "o_author_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Creator ID", "title": "O Author Id" }, "description": "Creator ID", "example": "7589271892177518598" }, { "name": "platform_channel", "in": "query", "required": false, "schema": { "type": "integer", "description": "Platform channel, default 1", "default": 1, "title": "Platform Channel" }, "description": "Platform channel, default 1", "example": 1 }, { "name": "platform_source", "in": "query", "required": false, "schema": { "type": "integer", "description": "Platform source, default 1", "default": 1, "title": "Platform Source" }, "description": "Platform source, default 1", "example": 1 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:38ca9f8a3b06c7370391f6541eb1e7d527afaaafa9f6d8248796a5fc68305fb9" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/xingtu_v2/get_author_link_info?industy_tag=0&o_author_id=7589271892177518598&platform_channel=1&platform_source=1' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu_v2-get_author_link_info" } }, "/apis/v1/tikhub/douyin/xingtu_v2/get_author_local_info": { "get": { "description": "Douyin (xingtu_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get creator/author location information\n\n### Parameters\n- o_author_id: Creator/author ID\n- platform_source: Platform source, default 1\n- platform_channel: Platform channel, default 1\n- time_range: Time range in days, default 30\n\n### Return\n- Creator location info data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_v2_get_author_local_info", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Creator location info data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_author_local_info", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "160fc8f9a3b0" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu_v2/get_author_local_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_v2_get_author_local_info", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu_v2/get_author_local_info" }, "parameters": [ { "name": "o_author_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Creator author ID", "title": "O Author Id" }, "description": "Creator author ID", "example": "7146074596666507300" }, { "name": "platform_channel", "in": "query", "required": false, "schema": { "type": "integer", "description": "Platform channel, default 1", "default": 1, "title": "Platform Channel" }, "description": "Platform channel, default 1", "example": 1 }, { "name": "platform_source", "in": "query", "required": false, "schema": { "type": "integer", "description": "Platform source, default 1", "default": 1, "title": "Platform Source" }, "description": "Platform source, default 1", "example": 1 }, { "name": "time_range", "in": "query", "required": false, "schema": { "type": "integer", "description": "Time range in days, default 30", "default": 30, "title": "Time Range" }, "description": "Time range in days, default 30", "example": 30 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:763bff568e3d8c0d32fd6cdfdb38272951757feacdee4a1d1d6a53879222914f" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/xingtu_v2/get_author_local_info?o_author_id=7146074596666507300&platform_channel=1&platform_source=1&time_range=30' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu_v2-get_author_local_info" } }, "/apis/v1/tikhub/douyin/xingtu_v2/get_author_market_fields": { "get": { "description": "Douyin (xingtu_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get all filter field options for the creator marketplace\n\n### Parameters\n- market_scene: Market scene, 1=default\n\n### Return\n- Creator marketplace filter fields data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_v2_get_author_market_fields", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Creator marketplace filter fields data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_author_market_fields", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "e6ad14684382" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu_v2/get_author_market_fields", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_v2_get_author_market_fields", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu_v2/get_author_market_fields" }, "parameters": [ { "name": "market_scene", "in": "query", "required": false, "schema": { "type": "integer", "description": "Market scene: 1=default", "default": 1, "title": "Market Scene" }, "description": "Market scene: 1=default", "example": 1 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:5991a9474b6248ccb63b34d3c910771693e35861564d8134d86de0e6f5d96da8" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu_v2-get_author_market_fields" } }, "/apis/v1/tikhub/douyin/xingtu_v2/get_author_rec_videos_v2": { "get": { "description": "Douyin (xingtu_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get a creator's recommended videos for representative content and recent performance\n\n### Parameters\n- o_author_id: Creator ID\n- platform_source: Platform source, default 1\n- platform_channel: Platform channel, default 1\n\n### Return\n- Recommended video list and related performance data\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_v2_get_author_rec_videos_v2", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Recommended video list and related performance data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_author_rec_videos", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "0fd75dadc7d1" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu_v2/get_author_rec_videos_v2", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_v2_get_author_rec_videos_v2", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu_v2/get_author_rec_videos_v2" }, "parameters": [ { "name": "o_author_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Creator ID", "title": "O Author Id" }, "description": "Creator ID", "example": "7112600044674482187" }, { "name": "platform_channel", "in": "query", "required": false, "schema": { "type": "integer", "description": "Platform channel: 1=Douyin video", "default": 1, "title": "Platform Channel" }, "description": "Platform channel: 1=Douyin video", "example": 1 }, { "name": "platform_source", "in": "query", "required": false, "schema": { "type": "integer", "description": "Platform source: 1=Douyin", "default": 1, "title": "Platform Source" }, "description": "Platform source: 1=Douyin", "example": 1 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:3e99dd433eeef1d88646d3464183a2fca447bfc3d148484e6981eef0585049e3" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/xingtu_v2/get_author_rec_videos_v2?o_author_id=7112600044674482187&platform_channel=1&platform_source=1' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu_v2-get_author_rec_videos_v2" } }, "/apis/v1/tikhub/douyin/xingtu_v2/get_author_show_items": { "get": { "description": "Douyin (xingtu_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get creator/author video list\n\n### Parameters\n- o_author_id: Creator/author ID\n- platform_source: Platform source, default 1\n- platform_channel: Platform channel, default 1\n- only_assign: Only show assigned videos (only for XingTu videos), default False\n- flow_type: Flow type, default 0\n\n### Return\n- Creator video list data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_v2_get_author_show_items", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Creator video list data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_author_show_items", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "11a9b531c755" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu_v2/get_author_show_items", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_v2_get_author_show_items", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu_v2/get_author_show_items" }, "parameters": [ { "name": "flow_type", "in": "query", "required": false, "schema": { "type": "integer", "description": "Flow type, default 0", "default": 0, "title": "Flow Type" }, "description": "Flow type, default 0", "example": 0 }, { "name": "o_author_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Creator author ID", "title": "O Author Id" }, "description": "Creator author ID", "example": "7589271892177518598" }, { "name": "only_assign", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Only show assigned videos (only for XingTu videos), default False", "default": false, "title": "Only Assign" }, "description": "Only show assigned videos (only for XingTu videos), default False", "example": false }, { "name": "platform_channel", "in": "query", "required": false, "schema": { "type": "integer", "description": "Platform channel, default 1", "default": 1, "title": "Platform Channel" }, "description": "Platform channel, default 1", "example": 1 }, { "name": "platform_source", "in": "query", "required": false, "schema": { "type": "integer", "description": "Platform source, default 1", "default": 1, "title": "Platform Source" }, "description": "Platform source, default 1", "example": 1 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:bcfa18f21a36e1f9ea4ea1c9ca2b3f4b279e54cb66fbb4574cb525680acec031" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/xingtu_v2/get_author_show_items?flow_type=0&o_author_id=7589271892177518598&only_assign=false&platform_channel=1&platform_source=1' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu_v2-get_author_show_items" } }, "/apis/v1/tikhub/douyin/xingtu_v2/get_author_spread_info": { "get": { "description": "Douyin (xingtu_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get creator/author spread value information (commercial capability)\n\n### Parameters\n- o_author_id: Creator/author ID\n- platform_source: Platform source, default 1\n- platform_channel: Platform channel, default 1\n- type: Video type, 1=personal video\n- flow_type: Flow type, default 0\n- only_assign: Only assigned videos, default False\n- range: Time range, 2=last 30 days, 3=last 90 days\n\n### Return\n- Creator spread value data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_v2_get_author_spread_info", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Creator spread value data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_author_spread_info", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "ffb359fb8c8b" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu_v2/get_author_spread_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_v2_get_author_spread_info", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu_v2/get_author_spread_info" }, "parameters": [ { "name": "flow_type", "in": "query", "required": false, "schema": { "type": "integer", "description": "Flow type, default 0", "default": 0, "title": "Flow Type" }, "description": "Flow type, default 0", "example": 0 }, { "name": "o_author_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Creator author ID", "title": "O Author Id" }, "description": "Creator author ID", "example": "7589271892177518598" }, { "name": "only_assign", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Only assigned videos", "default": false, "title": "Only Assign" }, "description": "Only assigned videos", "example": false }, { "name": "platform_channel", "in": "query", "required": false, "schema": { "type": "integer", "description": "Platform channel, default 1", "default": 1, "title": "Platform Channel" }, "description": "Platform channel, default 1", "example": 1 }, { "name": "platform_source", "in": "query", "required": false, "schema": { "type": "integer", "description": "Platform source, default 1", "default": 1, "title": "Platform Source" }, "description": "Platform source, default 1", "example": 1 }, { "name": "range", "in": "query", "required": false, "schema": { "type": "integer", "description": "Time range: 2=last 30 days, 3=last 90 days", "default": 2, "title": "Range" }, "description": "Time range: 2=last 30 days, 3=last 90 days", "example": 2 }, { "name": "type", "in": "query", "required": false, "schema": { "type": "integer", "description": "Video type, 1=personal video", "default": 1, "title": "Type" }, "description": "Video type, 1=personal video", "example": 1 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:76bc968c96a48b7b5fa5c9e8d20f52a5ff444cf47a651bc772dd8ff25e02a5b9" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/xingtu_v2/get_author_spread_info?flow_type=0&o_author_id=7589271892177518598&only_assign=false&platform_channel=1&platform_source=1&range=2&type=1' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu_v2-get_author_spread_info" } }, "/apis/v1/tikhub/douyin/xingtu_v2/get_author_spread_videos": { "get": { "description": "Douyin (xingtu_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get representative videos for evaluating a creator's content-spread performance\n\n### Return\n- Creator spread-video data\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_v2_get_author_spread_videos", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Creator spread-video data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_author_spread_videos", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "4e3d28cffd4f" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu_v2/get_author_spread_videos", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_v2_get_author_spread_videos", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu_v2/get_author_spread_videos" }, "parameters": [ { "name": "o_author_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Creator ID", "title": "O Author Id" }, "description": "Creator ID", "example": "7112600044674482187" }, { "name": "platform_channel", "in": "query", "required": false, "schema": { "type": "integer", "description": "Platform channel: 1 for short video", "default": 1, "title": "Platform Channel" }, "description": "Platform channel: 1 for short video" }, { "name": "platform_source", "in": "query", "required": false, "schema": { "type": "integer", "description": "Platform source: 1 for Douyin", "default": 1, "title": "Platform Source" }, "description": "Platform source: 1 for Douyin" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:a77d134615c9af1eb07e7dd662f6f98735a3154f70bed646ded548d4a594490c" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/xingtu_v2/get_author_spread_videos?o_author_id=7112600044674482187' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu_v2-get_author_spread_videos" } }, "/apis/v1/tikhub/douyin/xingtu_v2/get_author_touch_distribution": { "get": { "description": "Douyin (xingtu_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get creator video touch (reach) distribution data\n\n### Parameters\n- o_author_id: Creator ID\n- platform_source: Platform source, default 1\n- platform_channel: Platform channel, default 1\n\n### Return\n- Video touch distribution data\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_v2_get_author_touch_distribution", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Video touch distribution data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_author_touch_distribution", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "5f8442af071f" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu_v2/get_author_touch_distribution", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_v2_get_author_touch_distribution", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu_v2/get_author_touch_distribution" }, "parameters": [ { "name": "o_author_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Creator ID", "title": "O Author Id" }, "description": "Creator ID", "example": "7029342444797820939" }, { "name": "platform_channel", "in": "query", "required": false, "schema": { "type": "integer", "description": "Platform channel, default 1", "default": 1, "title": "Platform Channel" }, "description": "Platform channel, default 1", "example": 1 }, { "name": "platform_source", "in": "query", "required": false, "schema": { "type": "integer", "description": "Platform source, default 1", "default": 1, "title": "Platform Source" }, "description": "Platform source, default 1", "example": 1 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:f6776f5137ab0f54a9c9c21a111b584d4c88e9498eb89c8ce2de72275eb6e7a1" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/xingtu_v2/get_author_touch_distribution?o_author_id=7029342444797820939&platform_channel=1&platform_source=1' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu_v2-get_author_touch_distribution" } }, "/apis/v1/tikhub/douyin/xingtu_v2/get_author_video_distribution": { "get": { "description": "Douyin (xingtu_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get a creator's video-content distribution\n\n### Parameters\n- o_author_id: Creator ID\n- platform_source: Platform source, 1 for Douyin\n- platform_channel: Platform channel, 1 for short video\n\n### Return\n- Creator video-content distribution data\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_v2_get_author_video_distribution", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Creator video-content distribution data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_author_video_distribution", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "1f7b2933bbaa" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu_v2/get_author_video_distribution", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_v2_get_author_video_distribution", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu_v2/get_author_video_distribution" }, "parameters": [ { "name": "o_author_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Creator ID", "title": "O Author Id" }, "description": "Creator ID", "example": "7112600044674482187" }, { "name": "platform_channel", "in": "query", "required": false, "schema": { "type": "integer", "description": "Platform channel: 1 for short video", "default": 1, "title": "Platform Channel" }, "description": "Platform channel: 1 for short video" }, { "name": "platform_source", "in": "query", "required": false, "schema": { "type": "integer", "description": "Platform source: 1 for Douyin", "default": 1, "title": "Platform Source" }, "description": "Platform source: 1 for Douyin" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:4f25d4c0de8311d7a69ebfa822e1c6c9cd68efdd956de1e32bc2b03deff5edbf" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/xingtu_v2/get_author_video_distribution?o_author_id=7112600044674482187' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu_v2-get_author_video_distribution" } }, "/apis/v1/tikhub/douyin/xingtu_v2/get_content_trend_guide": { "get": { "description": "Douyin (xingtu_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get content trend guide data (CDN static JSON, no cookie needed)\n\n### Return\n- Content trend guide data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_v2_get_content_trend_guide", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Content trend guide data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_content_trend_guide", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "b54116f663b0" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu_v2/get_content_trend_guide", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_v2_get_content_trend_guide", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu_v2/get_content_trend_guide" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:25ede1113093da4c43efd31c99c40c439179feb47c1f2c9cdde647a59dd078d9" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu_v2-get_content_trend_guide" } }, "/apis/v1/tikhub/douyin/xingtu_v2/get_demander_mcn_list": { "get": { "description": "Douyin (xingtu_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Search MCN organization list\n\n### Parameters\n- mcn_name: MCN name, supports fuzzy search\n- page: Page number, default 1\n- order_by: Sort by, `platform_scores`=platform scores\n\n### Return\n- MCN organization list data\n\n\nPublished reference price: $0.005 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_v2_get_demander_mcn_list", "responses": { "200": { "description": "Successful Response\n\n### Return\n- MCN organization list data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_demander_mcn_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.005, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "9bd3bf35e3ea" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu_v2/get_demander_mcn_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_v2_get_demander_mcn_list", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu_v2/get_demander_mcn_list" }, "parameters": [ { "name": "mcn_name", "in": "query", "required": false, "schema": { "type": "string", "description": "MCN name, supports fuzzy search", "default": "", "title": "Mcn Name" }, "description": "MCN name, supports fuzzy search", "example": "" }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "description": "Sort by, `platform_scores`=platform scores", "default": "platform_scores", "title": "Order By" }, "description": "Sort by, `platform_scores`=platform scores", "example": "platform_scores" }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page number, default 1", "default": 1, "title": "Page" }, "description": "Page number, default 1", "example": 1 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:625be5e937bfa3f29a84e4016855ef5cfa6bb883deb4e47f2c6ef15aa8c719c0" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu_v2-get_demander_mcn_list" } }, "/apis/v1/tikhub/douyin/xingtu_v2/get_excellent_case_category_list": { "get": { "description": "Douyin (xingtu_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get the excellent case category list in the user connection funnel\n\n### Parameters\n- platform_source: Platform source, default 1\n\n### Return\n- Excellent case category list data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_v2_get_excellent_case_category_list", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Excellent case category list data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_excellent_case_category_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "0c49fded5e50" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu_v2/get_excellent_case_category_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_v2_get_excellent_case_category_list", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu_v2/get_excellent_case_category_list" }, "parameters": [ { "name": "platform_source", "in": "query", "required": false, "schema": { "type": "integer", "description": "Platform source, default 1", "default": 1, "title": "Platform Source" }, "description": "Platform source, default 1", "example": 1 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:5936bc00024ab2d8bd91cb03c94c0685c7575b7183ec47af2665c42480a26a8a" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu_v2-get_excellent_case_category_list" } }, "/apis/v1/tikhub/douyin/xingtu_v2/get_ip_activity_detail": { "get": { "description": "Douyin (xingtu_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get XingTu IP calendar activity detail\n\n### Parameters\n- id: Activity ID, from `get_ip_activity_list`\n\n### Return\n- IP activity detail data\n\nAPI references: `get_ip_activity_list` = `POST /tikhub/douyin/xingtu_v2/get_ip_activity_list` (operationId: `post_tikhub_douyin_xingtu_v2_get_ip_activity_list`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_v2_get_ip_activity_detail", "responses": { "200": { "description": "Successful Response\n\n### Return\n- IP activity detail data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_ip_activity_detail", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "fb5bf256e071" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu_v2/get_ip_activity_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_v2_get_ip_activity_detail", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu_v2/get_ip_activity_detail" }, "parameters": [ { "name": "id", "in": "query", "required": true, "schema": { "type": "integer", "description": "Activity ID from get_ip_activity_list\n\nAPI references: `get_ip_activity_list` = `POST /tikhub/douyin/xingtu_v2/get_ip_activity_list` (operationId: `post_tikhub_douyin_xingtu_v2_get_ip_activity_list`).", "title": "Id" }, "description": "Activity ID from get_ip_activity_list\n\nAPI references: `get_ip_activity_list` = `POST /tikhub/douyin/xingtu_v2/get_ip_activity_list` (operationId: `post_tikhub_douyin_xingtu_v2_get_ip_activity_list`).", "example": 347 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:efbdb049ecf8ddb24e34ce8d2626c3ea711421dd9a486a14582507dd95366590" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/xingtu_v2/get_ip_activity_detail?id=347' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu_v2-get_ip_activity_detail" } }, "/apis/v1/tikhub/douyin/xingtu_v2/get_ip_activity_industry_list": { "get": { "description": "Douyin (xingtu_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get the industry list for XingTu IP calendar\n\n### Return\n- Industry list data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_v2_get_ip_activity_industry_list", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Industry list data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_ip_activity_industry_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "b029d5ab5adc" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu_v2/get_ip_activity_industry_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_v2_get_ip_activity_industry_list", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu_v2/get_ip_activity_industry_list" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:fb09b0f71cc7843d194dc0f248287a1890d3c71dd23ed6faf96cacdc0c99283d" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu_v2-get_ip_activity_industry_list" } }, "/apis/v1/tikhub/douyin/xingtu_v2/get_ip_activity_list": { "post": { "description": "Douyin (xingtu_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get XingTu IP calendar activity list\n\n### Parameters\n- query_start_time: Query start timestamp, e.g. `1767196800`\n- query_end_time: Query end timestamp, e.g. `1774972799`\n- industry_id_list (optional): Industry ID list from `get_ip_activity_industry_list`\n - Example: `[\"1930\"]`=Beauty, `[\"1901\"]`=3C & Electronics, `[\"1903\"]`=Food & Beverage\n- category_list (optional): IP category list\n - 1=XingTu Big Event, 2=E-commerce Node, 3=Emotion Node, 4=Creative Marketing, 5=Industry Activity\n- status_list (optional): IP status list\n - 40=Preparing, 50=Recruiting, 30=Resources Online, 20=Ended\n\n### Return\n- IP calendar activity list data\n\nAPI references: `get_ip_activity_industry_list` = `GET /tikhub/douyin/xingtu_v2/get_ip_activity_industry_list` (operationId: `get_tikhub_douyin_xingtu_v2_get_ip_activity_industry_list`).\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_xingtu_v2_get_ip_activity_list", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- IP calendar activity list data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_ip_activity_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "8de49179c34c" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu_v2/get_ip_activity_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_xingtu_v2_get_ip_activity_list", "method": "POST", "path": "/apis/v1/tikhub/douyin/xingtu_v2/get_ip_activity_list" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "query_start_time": { "type": "string", "title": "Query Start Time", "description": "Query start timestamp, e.g. `1767196800`" }, "query_end_time": { "type": "string", "title": "Query End Time", "description": "Query end timestamp, e.g. `1774972799`" }, "industry_id_list": { "title": "Industry Id List", "description": "Industry ID list", "items": { "type": "string" }, "type": [ "array", "null" ] }, "category_list": { "title": "Category List", "description": "IP category list", "items": { "type": "integer" }, "type": [ "array", "null" ] }, "status_list": { "title": "Status List", "description": "IP status list", "items": { "type": "integer" }, "type": [ "array", "null" ] } }, "type": "object", "required": [ "query_start_time", "query_end_time" ], "title": "Body_get_ip_activity_list_api_v1_douyin_xingtu_v2_get_ip_activity_list_post" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:1bb2c27d2202cc4601d5ec9c45b305baa6fcf0d1c73816ab483dfc5aab43508f" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-xingtu_v2-get_ip_activity_list" } }, "/apis/v1/tikhub/douyin/xingtu_v2/get_item_play_count": { "get": { "description": "Douyin (xingtu_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get play count (watch_cnt) and full details of a single video (item);\n play count is surfaced at the top level for convenience\n- Note: watch_cnt is the total play count INCLUDING paid promotion (ad boost),\n returned with video details; for organic (non-promoted) play count, use Douyin\n App V3 `/tikhub/douyin/app/v3/fetch_video_statistics`\n\n### Parameters\n- item_id: Video (item) ID\n- platform_source: Platform source, default 1\n- need_cover_url: Whether to return cover URL, default true\n\n### Return\n- exist: Whether the video exists (false if deleted / invalid ID)\n- watch_cnt: Play count (int), null if unavailable\n- stats: Full stats block (like/comment/share/favorite/interaction rate/avg watch duration)\n- item: Full video details (title/cover/duration/create time/author ID, etc.)\n\nAPI references: `fetch_video_statistics` = `GET /tikhub/douyin/app/v3/fetch_video_statistics` (operationId: `get_tikhub_douyin_app_v3_fetch_video_statistics`).\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_v2_get_item_play_count", "responses": { "200": { "description": "Successful Response\n\n### Return\n- exist: Whether the video exists (false if deleted / invalid ID)\n- watch_cnt: Play count (int), null if unavailable\n- stats: Full stats block (like/comment/share/favorite/interaction rate/avg watch duration)\n- item: Full video details (title/cover/duration/create time/author ID, etc.)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_item_play_count", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "0c119ddb5779" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu_v2/get_item_play_count", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_v2_get_item_play_count", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu_v2/get_item_play_count" }, "parameters": [ { "name": "item_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Video (item) ID", "title": "Item Id" }, "description": "Video (item) ID", "example": "7630036460159111515" }, { "name": "need_cover_url", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether to return cover URL", "default": true, "title": "Need Cover Url" }, "description": "Whether to return cover URL", "example": true }, { "name": "platform_source", "in": "query", "required": false, "schema": { "type": "integer", "description": "Platform source, default 1", "default": 1, "title": "Platform Source" }, "description": "Platform source, default 1", "example": 1 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:68bd4c8c0f72b5d4251ee54865f04a2da5dc824947a9113cb97705269cc3bbcc" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/xingtu_v2/get_item_play_count?item_id=7630036460159111515&need_cover_url=true&platform_source=1' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu_v2-get_item_play_count" } }, "/apis/v1/tikhub/douyin/xingtu_v2/get_item_report_comments": { "post": { "description": "Douyin (xingtu_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get comment analysis for a video\n\n### Parameters\n- item_id: Video (item) ID\n\n### Return\n- Video comment analysis data\n\n\nPublished reference price: $0.003 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_xingtu_v2_get_item_report_comments", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Video comment analysis data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_item_report_comments", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.003, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "20d1644530d9" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu_v2/get_item_report_comments", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_xingtu_v2_get_item_report_comments", "method": "POST", "path": "/apis/v1/tikhub/douyin/xingtu_v2/get_item_report_comments" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "item_id": { "type": "string", "title": "Item Id", "description": "Video (item) ID" } }, "type": "object", "required": [ "item_id" ], "title": "Body_get_item_report_comments_api_v1_douyin_xingtu_v2_get_item_report_comments_post" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:39b0a5946a0820feb699d296de30b6540ea45bc97e504853806ea690312176d9" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-xingtu_v2-get_item_report_comments" } }, "/apis/v1/tikhub/douyin/xingtu_v2/get_item_report_detail": { "post": { "description": "Douyin (xingtu_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get a video's detail report and core performance metrics\n\n### Parameters\n- item_id: Video (item) ID\n\n### Return\n- Video information and detail-report data\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_xingtu_v2_get_item_report_detail", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Video information and detail-report data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_item_report_detail", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "78352ff54c51" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu_v2/get_item_report_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_xingtu_v2_get_item_report_detail", "method": "POST", "path": "/apis/v1/tikhub/douyin/xingtu_v2/get_item_report_detail" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "item_id": { "type": "string", "title": "Item Id", "description": "Video (item) ID" } }, "type": "object", "required": [ "item_id" ], "title": "Body_get_item_report_detail_api_v1_douyin_xingtu_v2_get_item_report_detail_post" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e3f9b2fe1cae9e4f13bf3de044bb3a57f973fc8414837c551d4e6013db15fd4c" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-xingtu_v2-get_item_report_detail" } }, "/apis/v1/tikhub/douyin/xingtu_v2/get_item_report_th_analysis": { "post": { "description": "Douyin (xingtu_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get interaction analysis for a video\n\n### Parameters\n- item_id: Video (item) ID\n\n### Return\n- Video interaction analysis data\n\n\nPublished reference price: $0.003 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_xingtu_v2_get_item_report_th_analysis", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Video interaction analysis data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_item_report_th_analysis", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.003, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "66810f0489e1" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu_v2/get_item_report_th_analysis", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_xingtu_v2_get_item_report_th_analysis", "method": "POST", "path": "/apis/v1/tikhub/douyin/xingtu_v2/get_item_report_th_analysis" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "item_id": { "type": "string", "title": "Item Id", "description": "Video (item) ID" } }, "type": "object", "required": [ "item_id" ], "title": "Body_get_item_report_th_analysis_api_v1_douyin_xingtu_v2_get_item_report_th_analysis_post" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:4649655b92186a48e635bf6782b416b011ec25dfca962d2f30dd98ea2442b611" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-xingtu_v2-get_item_report_th_analysis" } }, "/apis/v1/tikhub/douyin/xingtu_v2/get_item_report_trend": { "post": { "description": "Douyin (xingtu_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get overall performance and trend data for a video\n\n### Parameters\n- item_id: Video (item) ID\n\n### Return\n- Video performance trend data\n\n\nPublished reference price: $0.003 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_xingtu_v2_get_item_report_trend", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Video performance trend data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_item_report_trend", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.003, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "8814f06881e7" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu_v2/get_item_report_trend", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_xingtu_v2_get_item_report_trend", "method": "POST", "path": "/apis/v1/tikhub/douyin/xingtu_v2/get_item_report_trend" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "item_id": { "type": "string", "title": "Item Id", "description": "Video (item) ID" } }, "type": "object", "required": [ "item_id" ], "title": "Body_get_item_report_trend_api_v1_douyin_xingtu_v2_get_item_report_trend_post" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:24fe31fd5d6387a226114cc2a2a44613726b118b4117b0061c9e1ea789d040d2" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-xingtu_v2-get_item_report_trend" } }, "/apis/v1/tikhub/douyin/xingtu_v2/get_playlet_actor_rank_catalog": { "post": { "description": "Douyin (xingtu_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get XingTu playlet actor ranking catalog\n\n### Return\n- Playlet actor ranking catalog data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_xingtu_v2_get_playlet_actor_rank_catalog", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Playlet actor ranking catalog data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_playlet_actor_rank_catalog", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "09df1362d5de" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu_v2/get_playlet_actor_rank_catalog", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_xingtu_v2_get_playlet_actor_rank_catalog", "method": "POST", "path": "/apis/v1/tikhub/douyin/xingtu_v2/get_playlet_actor_rank_catalog" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:35e349332aeebd0c4bb1ddd0171d541101bfdec800cff4207041928753319c77" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-xingtu_v2-get_playlet_actor_rank_catalog" } }, "/apis/v1/tikhub/douyin/xingtu_v2/get_playlet_actor_rank_list": { "get": { "description": "Douyin (xingtu_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get XingTu playlet actor ranking list data\n\n### Parameters\n- category: Category, default `playlet_actor_list`\n- name: Ranking name, `playlet_actor_composite_list`=composite list\n- qualifier: Actor type, empty=all\n- period: 7=weekly, 30=monthly\n- date: Date, format YYYYMMDD\n\n### Return\n- Playlet actor ranking data\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_v2_get_playlet_actor_rank_list", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Playlet actor ranking data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_playlet_actor_rank_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a2dcd0f506e5" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu_v2/get_playlet_actor_rank_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_v2_get_playlet_actor_rank_list", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu_v2/get_playlet_actor_rank_list" }, "parameters": [ { "name": "category", "in": "query", "required": false, "schema": { "type": "string", "description": "Category, default `playlet_actor_list`", "default": "playlet_actor_list", "title": "Category" }, "description": "Category, default `playlet_actor_list`", "example": "playlet_actor_list" }, { "name": "date", "in": "query", "required": false, "schema": { "type": "string", "description": "Date, format YYYYMMDD", "default": "20251130", "title": "Date" }, "description": "Date, format YYYYMMDD", "example": "20251130" }, { "name": "name", "in": "query", "required": false, "schema": { "type": "string", "description": "Ranking name, `playlet_actor_composite_list`=composite list", "default": "playlet_actor_composite_list", "title": "Name" }, "description": "Ranking name, `playlet_actor_composite_list`=composite list", "example": "playlet_actor_composite_list" }, { "name": "period", "in": "query", "required": false, "schema": { "type": "integer", "description": "Period, 7=weekly, 30=monthly", "default": 30, "title": "Period" }, "description": "Period, 7=weekly, 30=monthly", "example": 30 }, { "name": "qualifier", "in": "query", "required": false, "schema": { "type": "string", "description": "Actor type, empty=all", "default": "", "title": "Qualifier" }, "description": "Actor type, empty=all", "example": "" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:bb2f60ab908a783316d49448c6e4dd4aa39c963841152c37f9bfc2ff69b33b11" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu_v2-get_playlet_actor_rank_list" } }, "/apis/v1/tikhub/douyin/xingtu_v2/get_ranking_list_catalog": { "get": { "description": "Douyin (xingtu_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get XingTu hot ranking list catalog, returns qualifier_id and other category information\n\n### Parameters\n- codes: Classification codes, default is empty string\n- biz_scene: Business scene\n - `douyin_flow_split_video_author_ranks`: Video creator ranking\n - `douyin_flow_split_live_author_ranks`: Live streamer ranking\n\n### Return\n- Hot ranking catalog data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_v2_get_ranking_list_catalog", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Hot ranking catalog data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_ranking_list_catalog", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "46631d4c96ab" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu_v2/get_ranking_list_catalog", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_v2_get_ranking_list_catalog", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu_v2/get_ranking_list_catalog" }, "parameters": [ { "name": "biz_scene", "in": "query", "required": false, "schema": { "type": "string", "description": "Business scene\n - `douyin_flow_split_video_author_ranks`: Video creator ranking\n - `douyin_flow_split_live_author_ranks`: Live streamer ranking", "default": "douyin_flow_split_video_author_ranks", "title": "Biz Scene" }, "description": "Business scene\n - `douyin_flow_split_video_author_ranks`: Video creator ranking\n - `douyin_flow_split_live_author_ranks`: Live streamer ranking", "example": "douyin_flow_split_video_author_ranks" }, { "name": "codes", "in": "query", "required": false, "schema": { "type": "string", "description": "Classification codes, default is empty string", "default": "", "title": "Codes" }, "description": "Classification codes, default is empty string", "example": "" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:fc4e5a3096ef842404645e16d378e0006a235b9d1aaf35586d587b3e983691b9" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu_v2-get_ranking_list_catalog" } }, "/apis/v1/tikhub/douyin/xingtu_v2/get_ranking_list_data": { "get": { "description": "Douyin (xingtu_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get XingTu creator business ranking list data\n- qualifier can be obtained from `get_ranking_list_catalog` API\n\n### Parameters\n- code: Ranking type code\n - Video business ranking: 1=Brand Premium, 2=A3 Seeding, 3=Search After Watch, 4=E-commerce, 5=Ad Flow, 6=High Potential\n - Video content ranking: 17=Follower Growth Dark Horse, 18=Top Must-Pick\n - Live streamer type: 23=Game Streamer, 30=Other Streamer, 37=E-commerce Streamer (version=base)\n - Live ranking type: 23=Game Brand Premium, 24=Non-game Brand Premium, 25=Component Click, 26=Download Conversion, 27=Lead Collection, 28=Ad Flow, 29=High Potential\n- qualifier: Category qualifier_id from `get_ranking_list_catalog`\n- version: `flow_split`=default for video rankings, `base`=commonly used for live rankings\n- period: 7=weekly, 30=monthly\n- date: Date, format YYYYMMDD\n\n### Return\n- Creator business ranking data\n\nAPI references: `get_ranking_list_catalog` = `GET /tikhub/douyin/xingtu_v2/get_ranking_list_catalog` (operationId: `get_tikhub_douyin_xingtu_v2_get_ranking_list_catalog`).\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_v2_get_ranking_list_data", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Creator business ranking data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_ranking_list_data", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "1fbc7e23dead" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu_v2/get_ranking_list_data", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_v2_get_ranking_list_data", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu_v2/get_ranking_list_data" }, "parameters": [ { "name": "code", "in": "query", "required": false, "schema": { "type": "integer", "description": "Ranking type code\n - Video business ranking: 1=Brand Premium, 2=A3 Seeding, 3=Search After Watch, 4=E-commerce, 5=Ad Flow, 6=High Potential\n - Video content ranking: 17=Follower Growth Dark Horse, 18=Top Must-Pick\n - Live streamer type: 23=Game Streamer, 30=Other Streamer, 37=E-commerce Streamer (version=base)\n - Live ranking type: 23=Game Brand Premium, 24=Non-game Brand Premium, 25=Component Click, 26=Download Conversion, 27=Lead Collection, 28=Ad Flow, 29=High Potential", "default": 1, "title": "Code" }, "description": "Ranking type code\n - Video business ranking: 1=Brand Premium, 2=A3 Seeding, 3=Search After Watch, 4=E-commerce, 5=Ad Flow, 6=High Potential\n - Video content ranking: 17=Follower Growth Dark Horse, 18=Top Must-Pick\n - Live streamer type: 23=Game Streamer, 30=Other Streamer, 37=E-commerce Streamer (version=base)\n - Live ranking type: 23=Game Brand Premium, 24=Non-game Brand Premium, 25=Component Click, 26=Download Conversion, 27=Lead Collection, 28=Ad Flow, 29=High Potential", "example": 1 }, { "name": "date", "in": "query", "required": false, "schema": { "type": "string", "description": "Date, format YYYYMMDD", "default": "20260131", "title": "Date" }, "description": "Date, format YYYYMMDD", "example": "20260131" }, { "name": "period", "in": "query", "required": false, "schema": { "type": "integer", "description": "Period, 7=weekly, 30=monthly", "default": 30, "title": "Period" }, "description": "Period, 7=weekly, 30=monthly", "example": 30 }, { "name": "qualifier", "in": "query", "required": false, "schema": { "type": "string", "description": "Category qualifier_id, obtained from get_ranking_list_catalog\n\nUsage: Category qualifier_id from `get_ranking_list_catalog`\n\nAPI references: `get_ranking_list_catalog` = `GET /tikhub/douyin/xingtu_v2/get_ranking_list_catalog` (operationId: `get_tikhub_douyin_xingtu_v2_get_ranking_list_catalog`).", "default": "1901", "title": "Qualifier" }, "description": "Category qualifier_id, obtained from get_ranking_list_catalog\n\nUsage: Category qualifier_id from `get_ranking_list_catalog`\n\nAPI references: `get_ranking_list_catalog` = `GET /tikhub/douyin/xingtu_v2/get_ranking_list_catalog` (operationId: `get_tikhub_douyin_xingtu_v2_get_ranking_list_catalog`).", "example": "1901" }, { "name": "version", "in": "query", "required": false, "schema": { "type": "string", "description": "Version\n\nUsage: `flow_split`=default for video rankings, `base`=commonly used for live rankings", "default": "flow_split", "title": "Version" }, "description": "Version\n\nUsage: `flow_split`=default for video rankings, `base`=commonly used for live rankings", "example": "flow_split" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:f4644adb1309b47ce8ab2ba0810d5a26fc760ceec6cb13ca00790c9a4d14da65" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu_v2-get_ranking_list_data" } }, "/apis/v1/tikhub/douyin/xingtu_v2/get_recommend_for_star_authors": { "post": { "description": "Douyin (xingtu_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get similar creator recommendation\n\n### Parameters\n- author_ids: List of creator/author IDs\n- similar_type: Similarity type\n - `comprehension`: Comprehensive similarity\n - `content`: Content similarity\n - `audience`: Audience similarity\n - `commercial`: Commercial capability similarity\n- page: Page number, default 1\n\n### Return\n- Similar creator recommendation data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_xingtu_v2_get_recommend_for_star_authors", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Similar creator recommendation data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_recommend_for_star_authors", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "22c21a362741" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu_v2/get_recommend_for_star_authors", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_xingtu_v2_get_recommend_for_star_authors", "method": "POST", "path": "/apis/v1/tikhub/douyin/xingtu_v2/get_recommend_for_star_authors" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "author_ids": { "items": { "type": "string" }, "type": "array", "title": "Author Ids", "description": "List of creator author IDs" }, "similar_type": { "type": "string", "title": "Similar Type", "description": "Similarity type\n - `comprehension`: Comprehensive similarity\n - `content`: Content similarity\n - `audience`: Audience similarity\n - `commercial`: Commercial capability similarity", "default": "content" }, "page": { "type": "integer", "title": "Page", "description": "Page number, default 1", "default": 1 } }, "type": "object", "required": [ "author_ids" ], "title": "Body_get_recommend_for_star_authors_api_v1_douyin_xingtu_v2_get_recommend_for_star_authors_post" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:ed2a6260eb5d06b9009268a6fad0e3c1da50aad39a5886a62545af7144a14028" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-xingtu_v2-get_recommend_for_star_authors" } }, "/apis/v1/tikhub/douyin/xingtu_v2/get_resource_list": { "get": { "description": "Douyin (xingtu_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get marketing activity resource list\n\n### Parameters\n- resource_id: Resource ID\n\n### Return\n- Marketing activity resource data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_v2_get_resource_list", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Marketing activity resource data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_resource_list", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "1cd7b5086f12" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu_v2/get_resource_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_v2_get_resource_list", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu_v2/get_resource_list" }, "parameters": [ { "name": "resource_id", "in": "query", "required": true, "schema": { "type": "integer", "description": "Resource ID", "title": "Resource Id" }, "description": "Resource ID", "example": 1052 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:fcf3fd530f618aaf18d38abc49a64b795c67d6227b4e97359da6fa8a3d5e256f" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/xingtu_v2/get_resource_list?resource_id=1052' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu_v2-get_resource_list" } }, "/apis/v1/tikhub/douyin/xingtu_v2/get_search_field_options": { "get": { "description": "Douyin (xingtu_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get filter option values that vary by cooperation type (task_category), such as\n fans/audience crowd profiles for the creator marketplace\n- Complements get_author_market_fields (age/gender/region/device); the two together\n form the complete set of options\n\n### Parameters\n- platform_source: Platform source, 1=Douyin, 2=Toutiao\n- task_category: Task category, 1=Douyin video, 6=Douyin live, 11=Toutiao article\n\n### Return\n- service_options: a map of field name to option list; each value is a JSON string\n and needs to be parsed by the caller\n\nAPI references: `get_author_market_fields` = `GET /tikhub/douyin/xingtu_v2/get_author_market_fields` (operationId: `get_tikhub_douyin_xingtu_v2_get_author_market_fields`).\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_v2_get_search_field_options", "responses": { "200": { "description": "Successful Response\n\n### Return\n- service_options: a map of field name to option list; each value is a JSON string\n and needs to be parsed by the caller", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_search_field_options", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "050540af47c5" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu_v2/get_search_field_options", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_v2_get_search_field_options", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu_v2/get_search_field_options" }, "parameters": [ { "name": "platform_source", "in": "query", "required": false, "schema": { "type": "integer", "description": "Platform source: 1=Douyin, 2=Toutiao", "default": 1, "title": "Platform Source" }, "description": "Platform source: 1=Douyin, 2=Toutiao", "example": 1 }, { "name": "task_category", "in": "query", "required": false, "schema": { "type": "integer", "description": "Task category: 1=Douyin video, 6=Douyin live, 11=Toutiao article", "default": 1, "title": "Task Category" }, "description": "Task category: 1=Douyin video, 6=Douyin live, 11=Toutiao article", "example": 1 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:f6426f13ec30c066dca6ed79af965159de1a278150e35097d76da7f18e3d0b9d" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu_v2-get_search_field_options" } }, "/apis/v1/tikhub/douyin/xingtu_v2/get_user_profile_qrcode": { "get": { "description": "Douyin (xingtu_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Generate user profile QR code\n- Either core_user_id or sec_uid is required\n\n### Parameters\n- core_user_id: User core ID (pick one with sec_uid)\n- sec_uid: User sec_uid (pick one with core_user_id)\n\n### Return\n- User profile QR code data\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_v2_get_user_profile_qrcode", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- User profile QR code data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_user_profile_qrcode", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a9303bb4bf78" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu_v2/get_user_profile_qrcode", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_v2_get_user_profile_qrcode", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu_v2/get_user_profile_qrcode" }, "parameters": [ { "name": "core_user_id", "in": "query", "required": false, "schema": { "description": "User core ID (pick one with sec_uid)", "title": "Core User Id", "type": [ "string", "null" ] }, "description": "User core ID (pick one with sec_uid)", "example": "1113181577281568" }, { "name": "sec_uid", "in": "query", "required": false, "schema": { "description": "User sec_uid (pick one with core_user_id)", "title": "Sec Uid", "type": [ "string", "null" ] }, "description": "User sec_uid (pick one with core_user_id)" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:a78e6bdf654c96926f50d5461992cd020d0df7d56f46e85cd03a5b6a8efa296d" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu_v2-get_user_profile_qrcode" } }, "/apis/v1/tikhub/douyin/xingtu_v2/get_xingtu_kolid_by_sec_user_id": { "get": { "description": "Douyin (xingtu_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get Xingtu author ID by Douyin sec_user_id\n\n### Parameters\n- sec_user_id: Douyin user sec_user_id, obtainable from Douyin user-profile endpoints\n\n### Return\n- Xingtu author ID data; returns exist=false if the user does not exist or has not joined Xingtu\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_v2_get_xingtu_kolid_by_sec_user_id", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Xingtu author ID data; returns exist=false if the user does not exist or has not joined Xingtu", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_xingtu_kolid_by_sec_user_id", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "xingtu_v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "39c087ab4fe0" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu_v2/get_xingtu_kolid_by_sec_user_id", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_v2_get_xingtu_kolid_by_sec_user_id", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu_v2/get_xingtu_kolid_by_sec_user_id" }, "parameters": [ { "name": "sec_user_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Douyin user sec_user_id, obtainable from Douyin user-profile endpoints", "title": "Sec User Id" }, "description": "Douyin user sec_user_id, obtainable from Douyin user-profile endpoints", "example": "MS4wLjABAAAAoxwUZouIdKL6sZ8EB96KDjkrhfBMS1KbCgsMJR1kIUs" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:d23030316058c98cb7c826684be555329164618053ac7c98eddcfd5a4a45d0e0" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/xingtu_v2/get_xingtu_kolid_by_sec_user_id?sec_user_id=MS4wLjABAAAAoxwUZouIdKL6sZ8EB96KDjkrhfBMS1KbCgsMJR1kIUs' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu_v2-get_xingtu_kolid_by_sec_user_id" } }, "/apis/v1/tikhub/douyin/xingtu_v2/get_xingtu_kolid_by_uid": { "get": { "description": "Douyin (xingtu_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get Xingtu author ID by Douyin user ID (uid)\n- The returned Xingtu author ID is the o_author_id required by other creator endpoints\n\n### Parameters\n- uid: Douyin user ID, obtainable from Douyin user-profile endpoints\n\n### Return\n- Xingtu author ID data; returns exist=false if the user does not exist or has not joined Xingtu\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_v2_get_xingtu_kolid_by_uid", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Xingtu author ID data; returns exist=false if the user does not exist or has not joined Xingtu", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_xingtu_kolid_by_uid", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "xingtu_v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "582544da5b3b" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu_v2/get_xingtu_kolid_by_uid", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_v2_get_xingtu_kolid_by_uid", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu_v2/get_xingtu_kolid_by_uid" }, "parameters": [ { "name": "uid", "in": "query", "required": true, "schema": { "type": "string", "description": "Douyin User ID (uid\n\nUsage: Douyin user ID, obtainable from Douyin user-profile endpoints", "title": "Uid" }, "description": "Douyin User ID (uid\n\nUsage: Douyin user ID, obtainable from Douyin user-profile endpoints", "example": "70452002324" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:d23030316058c98cb7c826684be555329164618053ac7c98eddcfd5a4a45d0e0" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/xingtu_v2/get_xingtu_kolid_by_uid?uid=70452002324' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu_v2-get_xingtu_kolid_by_uid" } }, "/apis/v1/tikhub/douyin/xingtu_v2/get_xingtu_kolid_by_unique_id": { "get": { "description": "Douyin (xingtu_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get Xingtu author ID by Douyin unique_id\n\n### Parameters\n- unique_id: Douyin unique_id\n\n### Return\n- Xingtu author ID data; returns exist=false if the user does not exist or has not joined Xingtu\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_v2_get_xingtu_kolid_by_unique_id", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Xingtu author ID data; returns exist=false if the user does not exist or has not joined Xingtu", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin get_xingtu_kolid_by_unique_id", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "xingtu_v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "f5d7d362a133" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu_v2/get_xingtu_kolid_by_unique_id", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_v2_get_xingtu_kolid_by_unique_id", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu_v2/get_xingtu_kolid_by_unique_id" }, "parameters": [ { "name": "unique_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Douyin User unique_id", "title": "Unique Id" }, "description": "Douyin User unique_id", "example": "m6640150" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:d23030316058c98cb7c826684be555329164618053ac7c98eddcfd5a4a45d0e0" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/xingtu_v2/get_xingtu_kolid_by_unique_id?unique_id=m6640150' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu_v2-get_xingtu_kolid_by_unique_id" } }, "/apis/v1/tikhub/douyin/xingtu_v2/multi_get_author_info": { "post": { "description": "Douyin (xingtu_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get info for multiple creators in one call, saving request quota\n\n### Parameters\n- author_ids: Creator ID list, up to 50 per call (exceeding returns an error)\n- platform_source: Platform source, default 1\n- platform_channel: Platform channel, default 1\n\n### Return\n- Creator info data (authors: matched creators, not_exist_author_ids: unknown IDs)\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_xingtu_v2_multi_get_author_info", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Creator info data (authors: matched creators, not_exist_author_ids: unknown IDs)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin multi_get_author_info", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "012eb670edf1" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu_v2/multi_get_author_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_xingtu_v2_multi_get_author_info", "method": "POST", "path": "/apis/v1/tikhub/douyin/xingtu_v2/multi_get_author_info" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "author_ids": { "items": { "type": "string" }, "type": "array", "title": "Author Ids", "description": "Creator ID list, up to 50 per call", "maxItems": 50 }, "platform_source": { "type": "integer", "title": "Platform Source", "description": "Platform source, default 1", "default": 1 }, "platform_channel": { "type": "integer", "title": "Platform Channel", "description": "Platform channel, default 1", "default": 1 } }, "type": "object", "required": [ "author_ids" ], "title": "Body_multi_get_author_info_api_v1_douyin_xingtu_v2_multi_get_author_info_post" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:4deb81bc8033ade476832d6b05db79c3a0ca8064d1b10570cf6be720317e3bc1" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-xingtu_v2-multi_get_author_info" } }, "/apis/v1/tikhub/douyin/xingtu_v2/multi_get_item_stats": { "post": { "description": "Douyin (xingtu_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Batch get play count and details for multiple videos (items), up to 20 per call\n- Each item has stats (watch_cnt/like_cnt/comment_cnt/share_cnt/favorite_cnt/\n interact_rate/avg_watch_dura) and video details\n- Note: watch_cnt is the total play count INCLUDING paid promotion (ad boost),\n with video details; for organic (non-promoted) play count, use Douyin App V3\n `/tikhub/douyin/app/v3/fetch_multi_video_statistics`\n- Upstream bills as 20 regardless (fewer than 20 still counts as 20); fill 20 for best value\n\n### Parameters\n- item_ids: Video (item) ID list, up to 20 per call (exceeding returns an error); auto de-dup\n- platform_source: Platform source, default 1\n- need_cover_url: Whether to return cover URL, default true\n\n### Return\n- items: Matched video list, each with stats and video details (invalid/deleted IDs are dropped upstream)\n\nAPI references: `fetch_multi_video_statistics` = `GET /tikhub/douyin/app/v3/fetch_multi_video_statistics` (operationId: `get_tikhub_douyin_app_v3_fetch_multi_video_statistics`).\n\n\nPublished reference price: $0.04 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_douyin_xingtu_v2_multi_get_item_stats", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- items: Matched video list, each with stats and video details (invalid/deleted IDs are dropped upstream)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin multi_get_item_stats", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.04, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "c0e4acb6c72b" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu_v2/multi_get_item_stats", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_douyin_xingtu_v2_multi_get_item_stats", "method": "POST", "path": "/apis/v1/tikhub/douyin/xingtu_v2/multi_get_item_stats" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "item_ids": { "items": { "type": "string" }, "type": "array", "title": "Item Ids", "description": "Video (item) ID list, up to 20 per call (exceeding returns an error); auto de-dup", "maxItems": 20 }, "platform_source": { "type": "integer", "title": "Platform Source", "description": "Platform source, default 1", "default": 1 }, "need_cover_url": { "type": "boolean", "title": "Need Cover Url", "description": "Whether to return cover URL", "default": true } }, "type": "object", "required": [ "item_ids" ], "title": "Body_multi_get_item_stats_api_v1_douyin_xingtu_v2_multi_get_item_stats_post" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:ee3d89d0ed7286c1e09e1d74b743e6caa65422707b6ec1b45d382efa7769f31c" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-douyin-xingtu_v2-multi_get_item_stats" } }, "/apis/v1/tikhub/douyin/xingtu_v2/search_anchor": { "get": { "description": "Douyin (xingtu_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Search Douyin live-stream anchors in the live marketplace by keyword, with full filtering\n\n### Parameters\n- keyword: Search keyword: nickname, Douyin ID, Xingtu ID or live content word\n- page: Page number, default 1\n- sort_field: Sort field, default `score` (comprehensive sort)\n- sort_type: Sort type, 1=asc, 2=desc, default 2\n- Cooperation: task_category, marketing_target, first_industry_id\n- Match: tag (category), persona_tags, gender, fans_min/fans_max\n- Cost-performance: expected_play_min/max, cpm_min/max,\n cpe_min/max, interact_rate_min/max, play_over_rate_min/max, burst_text_rate_min/max\n- Price: price_type is fixed to `9` for live-stream pricing; price_min/price_max define the\n anchor-price range and require price_type when either bound is supplied\n- Featured: author_list_id\n- Profile filters `extra_filter`: for audience/fans profile, region, connected-users, etc.\n Pass a JSON-array string; each element is `{\"field_name\":\"...\",\"field_value\":\"...\"}` (optional `rel_id`),\n Common fields:\n - Audience gender: `watcher_gender_female_rate_v2__ge` (female-ratio threshold 0.5/0.6/0.7/0.8),\n male uses `watcher_gender_male_rate_v2__ge`\n - Audience age: `watcher_age_most_new` (dominant audience age, encoded array, e.g. `[22]`=24-30)\n Example: `extra_filter=[{\"field_name\":\"watcher_gender_female_rate_v2__ge\",\"field_value\":\"0.5\"}]`\n- Note: valid IDs for tag/persona_tags come from `get_author_market_fields`; dynamic profile\n fields and codes come from `get_search_field_options`; rate params are 0-1 decimals (0.02=2%)\n\n### Return\n- Anchor search result data (anchor info, live price, ACU/PCU, avg viewers, etc.)\n\nAPI references: `get_author_market_fields` = `GET /tikhub/douyin/xingtu_v2/get_author_market_fields` (operationId: `get_tikhub_douyin_xingtu_v2_get_author_market_fields`); `get_search_field_options` = `GET /tikhub/douyin/xingtu_v2/get_search_field_options` (operationId: `get_tikhub_douyin_xingtu_v2_get_search_field_options`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_v2_search_anchor", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Anchor search result data (anchor info, live price, ACU/PCU, avg viewers, etc.)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin search_anchor", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "351cfa1dfabd" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu_v2/search_anchor", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_v2_search_anchor", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu_v2/search_anchor" }, "parameters": [ { "name": "author_list_id", "in": "query", "required": false, "schema": { "description": "Featured creator list ID", "title": "Author List Id", "type": [ "string", "null" ] }, "description": "Featured creator list ID" }, { "name": "burst_text_rate_max", "in": "query", "required": false, "schema": { "description": "Maximum viral-post rate, 0-1 decimal", "title": "Burst Text Rate Max", "type": [ "number", "null" ], "minimum": 0, "maximum": 1 }, "description": "Maximum viral-post rate, 0-1 decimal", "example": 0.8 }, { "name": "burst_text_rate_min", "in": "query", "required": false, "schema": { "description": "Minimum viral-post rate, 0-1 decimal", "title": "Burst Text Rate Min", "type": [ "number", "null" ], "minimum": 0, "maximum": 1 }, "description": "Minimum viral-post rate, 0-1 decimal", "example": 0.1 }, { "name": "cpe_max", "in": "query", "required": false, "schema": { "description": "Maximum expected CPE", "title": "Cpe Max", "type": [ "number", "null" ] }, "description": "Maximum expected CPE", "example": 5 }, { "name": "cpe_min", "in": "query", "required": false, "schema": { "description": "Minimum expected CPE", "title": "Cpe Min", "type": [ "number", "null" ] }, "description": "Minimum expected CPE", "example": 0.1 }, { "name": "cpm_max", "in": "query", "required": false, "schema": { "description": "Maximum expected CPM", "title": "Cpm Max", "type": [ "number", "null" ] }, "description": "Maximum expected CPM", "example": 100 }, { "name": "cpm_min", "in": "query", "required": false, "schema": { "description": "Minimum expected CPM", "title": "Cpm Min", "type": [ "number", "null" ] }, "description": "Minimum expected CPM", "example": 10 }, { "name": "expected_play_max", "in": "query", "required": false, "schema": { "description": "Maximum expected plays", "title": "Expected Play Max", "type": [ "integer", "null" ] }, "description": "Maximum expected plays", "example": 1000000 }, { "name": "expected_play_min", "in": "query", "required": false, "schema": { "description": "Minimum expected plays", "title": "Expected Play Min", "type": [ "integer", "null" ] }, "description": "Minimum expected plays", "example": 100000 }, { "name": "extra_filter", "in": "query", "required": false, "schema": { "description": "Extra profile filters as a JSON-array string; field_name and field_value must be non-empty strings", "title": "Extra Filter", "type": [ "string", "null" ] }, "description": "Extra profile filters as a JSON-array string; field_name and field_value must be non-empty strings", "example": "[{\"field_name\":\"content_theme_labels_180d\",\"field_value\":\"[\\\"生活好物评测\\\"]\"},{\"field_name\":\"watcher_gender_female_rate_v2__ge\",\"field_value\":\"0.6\"},{\"field_name\":\"link_crowd_profile\",\"field_value\":\"[60,55,53,57]\"}]" }, { "name": "fans_max", "in": "query", "required": false, "schema": { "description": "Maximum followers", "title": "Fans Max", "type": [ "integer", "null" ] }, "description": "Maximum followers", "example": 1000000 }, { "name": "fans_min", "in": "query", "required": false, "schema": { "description": "Minimum followers", "title": "Fans Min", "type": [ "integer", "null" ] }, "description": "Minimum followers", "example": 10000 }, { "name": "first_industry_id", "in": "query", "required": false, "schema": { "description": "Industry ID", "title": "First Industry Id", "type": [ "integer", "null" ] }, "description": "Industry ID" }, { "name": "gender", "in": "query", "required": false, "schema": { "description": "Creator gender, 1=male, 2=female", "title": "Gender", "type": [ "integer", "null" ] }, "description": "Creator gender, 1=male, 2=female", "example": 2 }, { "name": "interact_rate_max", "in": "query", "required": false, "schema": { "description": "Maximum interaction rate, 0-1 decimal", "title": "Interact Rate Max", "type": [ "number", "null" ], "minimum": 0, "maximum": 1 }, "description": "Maximum interaction rate, 0-1 decimal", "example": 0.5 }, { "name": "interact_rate_min", "in": "query", "required": false, "schema": { "description": "Minimum interaction rate, 0-1 decimal (e.g. 0.02=2%)", "title": "Interact Rate Min", "type": [ "number", "null" ], "minimum": 0, "maximum": 1 }, "description": "Minimum interaction rate, 0-1 decimal (e.g. 0.02=2%)", "example": 0.02 }, { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Search keyword: nickname, Douyin ID, Xingtu ID or live content word", "title": "Keyword" }, "description": "Search keyword: nickname, Douyin ID, Xingtu ID or live content word", "example": "Gaming" }, { "name": "marketing_target", "in": "query", "required": false, "schema": { "type": "integer", "description": "Marketing target", "default": 3, "title": "Marketing Target" }, "description": "Marketing target", "example": 3 }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page number", "default": 1, "title": "Page" }, "description": "Page number", "example": 1 }, { "name": "persona_tags", "in": "query", "required": false, "schema": { "description": "Persona IDs (persona/education/certification/tone). Comma=match any; semicolon=group AND, e.g. `1129,110401;110213`", "title": "Persona Tags", "type": [ "string", "null" ] }, "description": "Persona IDs (persona/education/certification/tone). Comma=match any; semicolon=group AND, e.g. `1129,110401;110213`", "example": "1129,110401" }, { "name": "play_over_rate_max", "in": "query", "required": false, "schema": { "description": "Maximum play-completion rate, 0-1 decimal", "title": "Play Over Rate Max", "type": [ "number", "null" ], "minimum": 0, "maximum": 1 }, "description": "Maximum play-completion rate, 0-1 decimal", "example": 0.9 }, { "name": "play_over_rate_min", "in": "query", "required": false, "schema": { "description": "Minimum play-completion rate, 0-1 decimal", "title": "Play Over Rate Min", "type": [ "number", "null" ], "minimum": 0, "maximum": 1 }, "description": "Minimum play-completion rate, 0-1 decimal", "example": 0.05 }, { "name": "price_max", "in": "query", "required": false, "schema": { "description": "Maximum anchor price; price_type must also be provided when this field is supplied", "title": "Price Max", "type": [ "integer", "null" ], "minimum": 0 }, "description": "Maximum anchor price; price_type must also be provided when this field is supplied", "example": 100000 }, { "name": "price_min", "in": "query", "required": false, "schema": { "description": "Minimum anchor price; price_type must also be provided when this field is supplied", "title": "Price Min", "type": [ "integer", "null" ], "minimum": 0 }, "description": "Minimum anchor price; price_type must also be provided when this field is supplied", "example": 1000 }, { "name": "price_type", "in": "query", "required": false, "schema": { "description": "Live-stream price type, fixed to 9; used only in combination with price_min/price_max", "title": "Price Type", "anyOf": [ { "description": "Live-stream price type, fixed to 9; used only in combination with price_min/price_max", "title": "Price Type", "allOf": [ { "type": "integer", "enum": [ 9 ], "title": "XingtuAnchorPriceType" } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "description": "Live-stream price type, fixed to 9; used only in combination with price_min/price_max", "example": 9 }, { "name": "sort_field", "in": "query", "required": false, "schema": { "type": "string", "description": "Sort field, default score (comprehensive)", "default": "score", "title": "Sort Field" }, "description": "Sort field, default score (comprehensive)", "example": "score" }, { "name": "sort_type", "in": "query", "required": false, "schema": { "type": "integer", "description": "Sort type: 1=asc, 2=desc", "default": 2, "title": "Sort Type" }, "description": "Sort type: 1=asc, 2=desc", "example": 2 }, { "name": "tag", "in": "query", "required": false, "schema": { "description": "Creator category IDs, comma-separated, e.g. `1,6`", "title": "Tag", "type": [ "string", "null" ] }, "description": "Creator category IDs, comma-separated, e.g. `1,6`", "example": "1" }, { "name": "task_category", "in": "query", "required": false, "schema": { "type": "integer", "description": "Cooperation target", "default": 6, "title": "Task Category" }, "description": "Cooperation target", "example": 6 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:bed2defff9f27a6c40b71f18d39eef431324e9cba4665b3b1b9bde7fe0e1ee17" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/xingtu_v2/search_anchor?burst_text_rate_max=0.8&burst_text_rate_min=0.1&cpe_max=5&cpe_min=0.1&cpm_max=100&cpm_min=10&expected_play_max=1000000&expected_play_min=100000&extra_filter=%5B%7B%22field_name%22%3A%22content_theme_labels_180d%22%2C%22field_value%22%3A%22%5B%5C%22%E7%94%9F%E6%B4%BB%E5%A5%BD%E7%89%A9%E8%AF%84%E6%B5%8B%5C%22%5D%22%7D%2C%7B%22field_name%22%3A%22watcher_gender_female_rate_v2__ge%22%2C%22field_value%22%3A%220.6%22%7D%2C%7B%22field_name%22%3A%22link_crowd_profile%22%2C%22field_value%22%3A%22%5B60%2C55%2C53%2C57%5D%22%7D%5D&fans_max=1000000&fans_min=10000&gender=2&interact_rate_max=0.5&interact_rate_min=0.02&keyword=Gaming&marketing_target=3&page=1&persona_tags=1129%2C110401&play_over_rate_max=0.9&play_over_rate_min=0.05&price_max=100000&price_min=1000&price_type=9&sort_field=score&sort_type=2&tag=1&task_category=6' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu_v2-search_anchor" } }, "/apis/v1/tikhub/douyin/xingtu_v2/search_creator": { "get": { "description": "Douyin (xingtu_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Search or filter Douyin short-video creators with keyword, cooperation, creator profile,\n performance, price, content-theme, and audience-profile filters.\n- `keyword` may be empty for filter-only browsing.\n\n### Basic search parameters\n- `keyword`: Optional search term; nickname text for `seach_type=2`, content text for\n `seach_type=3`. Leave empty to use filters only.\n- `seach_type`: `2`=nickname (default), `3`=content.\n- `time_range_days`: Content range of `30`, `90`, or `180` days; only applies to content search.\n- `page`: Page number starting from 1.\n- `sort_field`: Sort field; default `score`.\n- `sort_type`: `1`=ascending, `2`=descending.\n\n### Cooperation and match parameters\n- `task_category`: Cooperation target or task category.\n- `marketing_target`: Marketing objective.\n- `first_industry_id`: First-level industry ID; `0` means unrestricted.\n- `author_list_id`: Featured creator-list ID.\n- `tag`: Creator-category IDs, comma-separated.\n- `persona_tags`: Persona/education/certification/style IDs. Commas mean OR within a group;\n semicolons separate groups that must all match.\n- `gender`: Creator gender, `1`=male, `2`=female.\n- `fans_min` / `fans_max`: Follower-count range.\n\n### Performance and price parameters\n- `expected_play_min` / `expected_play_max`: Expected-play range.\n- `cpm_min` / `cpm_max`: Expected cost-per-thousand-play range.\n- `cpe_min` / `cpe_max`: Expected cost-per-engagement range.\n- `interact_rate_min` / `interact_rate_max`: Interaction-rate range as 0-1 decimals.\n- `play_over_rate_min` / `play_over_rate_max`: Completion-rate range as 0-1 decimals.\n- `burst_text_rate_min` / `burst_text_rate_max`: Viral-post-rate range as 0-1 decimals.\n- `price_type`: Video-length price tier: `1`=1-20s, `2`=21-60s, `3`=over 60s.\n- `price_min` / `price_max`: Creator-price range. `price_type` is required when either bound\n is supplied. Omitting both bounds disables price filtering.\n\n### Extended profile filters\n- `extra_filter`: JSON-array string for content themes, audience/fan profiles, crowd segments,\n region, and other dynamic filters. Every item requires non-empty string `field_name` and\n `field_value`.\n- Common fields: `content_theme_labels_180d`, `watcher_gender_female_rate_v2__ge`,\n `watcher_gender_male_rate_v2__ge`, `watcher_age_most_new`, and `link_crowd_profile`.\n- Use `get_author_market_fields` for creator-field IDs and `get_search_field_options` for\n dynamic profile fields and codes.\n\n### Return\n- Creator results, pagination information, and related metrics.\n\n### Example 1: nickname search\nkeyword = \"airplane\"\nseach_type = 2\n\n### Example 2: content search\nkeyword = \"airplane\"\nseach_type = 3\ntime_range_days = 180\n\n### Example 3: filter-only search\nkeyword = \"\"\nseach_type = 3\ntime_range_days = 180\npage = 1\nsort_field = \"score\"\nsort_type = 2\ntask_category = 1\nmarketing_target = 1\nfirst_industry_id = 0\ntag = \"36\"\ngender = 2\nfans_min = 100000\nfans_max = 200000\nextra_filter = '[{\"field_name\":\"content_theme_labels_180d\",\"field_value\":\"[\\\"生活好物评测\\\"]\"},{\"field_name\":\"watcher_gender_female_rate_v2__ge\",\"field_value\":\"0.6\"},{\"field_name\":\"link_crowd_profile\",\"field_value\":\"[60,55,53,57]\"}]'\n\nCopy content-theme labels in extra_filter verbatim from the filter options; Chinese labels are required wire values.\n\nAPI references: `get_author_market_fields` = `GET /tikhub/douyin/xingtu_v2/get_author_market_fields` (operationId: `get_tikhub_douyin_xingtu_v2_get_author_market_fields`); `get_search_field_options` = `GET /tikhub/douyin/xingtu_v2/get_search_field_options` (operationId: `get_tikhub_douyin_xingtu_v2_get_search_field_options`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_v2_search_creator", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Creator results, pagination information, and related metrics.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin search_creator", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "088f89c1920e" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu_v2/search_creator", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_v2_search_creator", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu_v2/search_creator" }, "parameters": [ { "name": "author_list_id", "in": "query", "required": false, "schema": { "description": "Featured creator list ID", "title": "Author List Id", "type": [ "string", "null" ] }, "description": "Featured creator list ID" }, { "name": "burst_text_rate_max", "in": "query", "required": false, "schema": { "description": "Maximum viral-post rate as a decimal between 0 and 1.", "title": "Burst Text Rate Max", "type": [ "number", "null" ], "minimum": 0, "maximum": 1 }, "description": "Maximum viral-post rate as a decimal between 0 and 1.", "example": 0.8 }, { "name": "burst_text_rate_min", "in": "query", "required": false, "schema": { "description": "Minimum viral-post rate as a decimal between 0 and 1.", "title": "Burst Text Rate Min", "type": [ "number", "null" ], "minimum": 0, "maximum": 1 }, "description": "Minimum viral-post rate as a decimal between 0 and 1.", "example": 0.1 }, { "name": "cpe_max", "in": "query", "required": false, "schema": { "description": "Maximum expected CPE", "title": "Cpe Max", "type": [ "number", "null" ] }, "description": "Maximum expected CPE", "example": 5 }, { "name": "cpe_min", "in": "query", "required": false, "schema": { "description": "Minimum expected CPE", "title": "Cpe Min", "type": [ "number", "null" ] }, "description": "Minimum expected CPE", "example": 0.1 }, { "name": "cpm_max", "in": "query", "required": false, "schema": { "description": "Maximum expected CPM", "title": "Cpm Max", "type": [ "number", "null" ] }, "description": "Maximum expected CPM", "example": 100 }, { "name": "cpm_min", "in": "query", "required": false, "schema": { "description": "Minimum expected CPM", "title": "Cpm Min", "type": [ "number", "null" ] }, "description": "Minimum expected CPM", "example": 10 }, { "name": "expected_play_max", "in": "query", "required": false, "schema": { "description": "Maximum expected plays", "title": "Expected Play Max", "type": [ "integer", "null" ] }, "description": "Maximum expected plays", "example": 1000000 }, { "name": "expected_play_min", "in": "query", "required": false, "schema": { "description": "Minimum expected plays", "title": "Expected Play Min", "type": [ "integer", "null" ] }, "description": "Minimum expected plays", "example": 100000 }, { "name": "extra_filter", "in": "query", "required": false, "schema": { "description": "Extra profile filters encoded as a JSON-array string. Each item must include non-empty string field_name and field_value; related-tier filters may also include rel_id. Supports content themes, viewer/follower profiles, audience groups, locations, and dynamic filter options.", "title": "Extra Filter", "type": [ "string", "null" ] }, "description": "Extra profile filters encoded as a JSON-array string. Each item must include non-empty string field_name and field_value; related-tier filters may also include rel_id. Supports content themes, viewer/follower profiles, audience groups, locations, and dynamic filter options.", "example": "[{\"field_name\":\"content_theme_labels_180d\",\"field_value\":\"[\\\"生活好物评测\\\"]\"},{\"field_name\":\"watcher_gender_female_rate_v2__ge\",\"field_value\":\"0.6\"},{\"field_name\":\"link_crowd_profile\",\"field_value\":\"[60,55,53,57]\"}]" }, { "name": "fans_max", "in": "query", "required": false, "schema": { "description": "Maximum follower count, for example 200000 for at most 200,000 followers.", "title": "Fans Max", "type": [ "integer", "null" ] }, "description": "Maximum follower count, for example 200000 for at most 200,000 followers.", "example": 1000000 }, { "name": "fans_min", "in": "query", "required": false, "schema": { "description": "Minimum follower count, for example 100000 for at least 100,000 followers.", "title": "Fans Min", "type": [ "integer", "null" ] }, "description": "Minimum follower count, for example 100000 for at least 100,000 followers.", "example": 10000 }, { "name": "first_industry_id", "in": "query", "required": false, "schema": { "type": "integer", "description": "Industry ID, 0=unlimited\n\nUsage: First-level industry ID; `0` means unrestricted.", "default": 0, "title": "First Industry Id" }, "description": "Industry ID, 0=unlimited\n\nUsage: First-level industry ID; `0` means unrestricted.", "example": 0 }, { "name": "gender", "in": "query", "required": false, "schema": { "description": "Creator gender, 1=male, 2=female", "title": "Gender", "type": [ "integer", "null" ] }, "description": "Creator gender, 1=male, 2=female", "example": 2 }, { "name": "interact_rate_max", "in": "query", "required": false, "schema": { "description": "Maximum interaction rate as a decimal between 0 and 1.", "title": "Interact Rate Max", "type": [ "number", "null" ], "minimum": 0, "maximum": 1 }, "description": "Maximum interaction rate as a decimal between 0 and 1.", "example": 0.5 }, { "name": "interact_rate_min", "in": "query", "required": false, "schema": { "description": "Minimum interaction rate as a decimal between 0 and 1; 0.02 means 2%.", "title": "Interact Rate Min", "type": [ "number", "null" ], "minimum": 0, "maximum": 1 }, "description": "Minimum interaction rate as a decimal between 0 and 1; 0.02 means 2%.", "example": 0.02 }, { "name": "keyword", "in": "query", "required": false, "schema": { "type": "string", "description": "Optional keyword; empty means filter-only browsing. seach_type=2 matches nickname, =3 matches content", "default": "", "title": "Keyword" }, "description": "Optional keyword; empty means filter-only browsing. seach_type=2 matches nickname, =3 matches content", "example": "Fitness" }, { "name": "marketing_target", "in": "query", "required": false, "schema": { "type": "integer", "description": "Marketing target", "default": 1, "title": "Marketing Target" }, "description": "Marketing target", "example": 1 }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page number starting from 1.", "default": 1, "title": "Page" }, "description": "Page number starting from 1.", "example": 1 }, { "name": "persona_tags", "in": "query", "required": false, "schema": { "description": "Persona IDs (persona/education/certification/tone). Comma=match any; semicolon=group AND, e.g. `1129,110401;110213`", "title": "Persona Tags", "type": [ "string", "null" ] }, "description": "Persona IDs (persona/education/certification/tone). Comma=match any; semicolon=group AND, e.g. `1129,110401;110213`", "example": "1129,110401" }, { "name": "play_over_rate_max", "in": "query", "required": false, "schema": { "description": "Maximum play-completion rate as a decimal between 0 and 1.", "title": "Play Over Rate Max", "type": [ "number", "null" ], "minimum": 0, "maximum": 1 }, "description": "Maximum play-completion rate as a decimal between 0 and 1.", "example": 0.9 }, { "name": "play_over_rate_min", "in": "query", "required": false, "schema": { "description": "Minimum play-completion rate as a decimal between 0 and 1.", "title": "Play Over Rate Min", "type": [ "number", "null" ], "minimum": 0, "maximum": 1 }, "description": "Minimum play-completion rate as a decimal between 0 and 1.", "example": 0.05 }, { "name": "price_max", "in": "query", "required": false, "schema": { "description": "Maximum creator price. Supply price_type whenever this field is set.", "title": "Price Max", "type": [ "integer", "null" ], "minimum": 0 }, "description": "Maximum creator price. Supply price_type whenever this field is set.", "example": 100000 }, { "name": "price_min", "in": "query", "required": false, "schema": { "description": "Minimum creator price. Supply price_type whenever this field is set.", "title": "Price Min", "type": [ "integer", "null" ], "minimum": 0 }, "description": "Minimum creator price. Supply price_type whenever this field is set.", "example": 1000 }, { "name": "price_type", "in": "query", "required": false, "schema": { "description": "Creator video price tier: 1=1-20 seconds, 2=21-60 seconds, 3=60 seconds or above; used only in combination with price_min/price_max", "title": "Price Type", "anyOf": [ { "description": "Creator video price tier: 1=1-20 seconds, 2=21-60 seconds, 3=60 seconds or above; used only in combination with price_min/price_max", "title": "Price Type", "allOf": [ { "type": "integer", "enum": [ 1, 2, 3 ], "title": "XingtuCreatorPriceType" } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "description": "Creator video price tier: 1=1-20 seconds, 2=21-60 seconds, 3=60 seconds or above; used only in combination with price_min/price_max", "example": 2 }, { "name": "seach_type", "in": "query", "required": false, "schema": { "description": "Search mode: 2=by nickname, 3=by content\n\nUsage: `2`=nickname (default), `3`=content.", "default": 2, "allOf": [ { "type": "integer", "enum": [ 2, 3 ], "title": "XingtuCreatorSearchType" } ] }, "description": "Search mode: 2=by nickname, 3=by content\n\nUsage: `2`=nickname (default), `3`=content.", "example": 2 }, { "name": "sort_field", "in": "query", "required": false, "schema": { "type": "string", "description": "Sort field, default score (comprehensive)", "default": "score", "title": "Sort Field" }, "description": "Sort field, default score (comprehensive)", "example": "score" }, { "name": "sort_type", "in": "query", "required": false, "schema": { "type": "integer", "description": "Sort type: 1=asc, 2=desc\n\nUsage: `1`=ascending, `2`=descending.", "default": 2, "title": "Sort Type" }, "description": "Sort type: 1=asc, 2=desc\n\nUsage: `1`=ascending, `2`=descending.", "example": 2 }, { "name": "tag", "in": "query", "required": false, "schema": { "description": "Creator category IDs, comma-separated, e.g. `1,6`", "title": "Tag", "type": [ "string", "null" ] }, "description": "Creator category IDs, comma-separated, e.g. `1,6`", "example": "1" }, { "name": "task_category", "in": "query", "required": false, "schema": { "type": "integer", "description": "Cooperation target", "default": 1, "title": "Task Category" }, "description": "Cooperation target", "example": 1 }, { "name": "time_range_days", "in": "query", "required": false, "schema": { "description": "Content time range; only effective when seach_type=3\n\nUsage: Content range of `30`, `90`, or `180` days; only applies to content search.", "default": 180, "allOf": [ { "type": "integer", "enum": [ 30, 90, 180 ], "title": "XingtuContentSearchTimeRange" } ] }, "description": "Content time range; only effective when seach_type=3\n\nUsage: Content range of `30`, `90`, or `180` days; only applies to content search.", "example": 180 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:ddbdf4e6bc5b43ab618065d1eb70521b19b2ac62b9c9d1af47797ed0ec8ac729" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu_v2-search_creator" } }, "/apis/v1/tikhub/douyin/xingtu_v2/search_toutiao_creator": { "get": { "description": "Douyin (xingtu_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Search Toutiao image-text creators in the image-text marketplace by keyword, with full filtering\n\n### Parameters\n- keyword: Search keyword: nickname, Toutiao ID or content word\n- page: Page number, default 1\n- sort_field: Sort field, default `score` (comprehensive sort)\n- sort_type: Sort type, 1=asc, 2=desc, default 2\n- Cooperation: task_category, marketing_target, first_industry_id\n- Match: tag (category), persona_tags, gender, fans_min/fans_max\n- Cost-performance: expected_play_min/max, cpm_min/max,\n cpe_min/max, interact_rate_min/max, play_over_rate_min/max, burst_text_rate_min/max\n- Price: price_type is fixed to `11` for Toutiao image-text pricing; price_min/price_max define\n the price range and require price_type when either bound is supplied\n- Featured: author_list_id\n- Profile filters `extra_filter`: for audience/fans profile, region, connected-users, etc.\n Pass a JSON-array string; each element is `{\"field_name\":\"...\",\"field_value\":\"...\"}` (optional `rel_id`),\n Common fields:\n - Audience gender: `watcher_gender_female_rate_v2__ge` (female-ratio threshold 0.5/0.6/0.7/0.8),\n male uses `watcher_gender_male_rate_v2__ge`\n - Audience age: `watcher_age_most_new` (dominant audience age, encoded array, e.g. `[22]`=24-30)\n Example: `extra_filter=[{\"field_name\":\"watcher_gender_female_rate_v2__ge\",\"field_value\":\"0.5\"}]`\n- Note: valid IDs for tag/persona_tags come from `get_author_market_fields`; dynamic profile\n fields and codes come from `get_search_field_options`; rate params are 0-1 decimals (0.02=2%)\n\n### Return\n- Toutiao creator search result data (creator info, price, followers, expected reads, etc.)\n\nAPI references: `get_author_market_fields` = `GET /tikhub/douyin/xingtu_v2/get_author_market_fields` (operationId: `get_tikhub_douyin_xingtu_v2_get_author_market_fields`); `get_search_field_options` = `GET /tikhub/douyin/xingtu_v2/get_search_field_options` (operationId: `get_tikhub_douyin_xingtu_v2_get_search_field_options`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_douyin_xingtu_v2_search_toutiao_creator", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Toutiao creator search result data (creator info, price, followers, expected reads, etc.)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "douyin search_toutiao_creator", "tags": [ "tikhub.douyin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "7dde76311a6e" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/douyin/xingtu_v2/search_toutiao_creator", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_douyin_xingtu_v2_search_toutiao_creator", "method": "GET", "path": "/apis/v1/tikhub/douyin/xingtu_v2/search_toutiao_creator" }, "parameters": [ { "name": "author_list_id", "in": "query", "required": false, "schema": { "description": "Featured creator list ID", "title": "Author List Id", "type": [ "string", "null" ] }, "description": "Featured creator list ID" }, { "name": "burst_text_rate_max", "in": "query", "required": false, "schema": { "description": "Maximum viral-post rate, 0-1 decimal", "title": "Burst Text Rate Max", "type": [ "number", "null" ], "minimum": 0, "maximum": 1 }, "description": "Maximum viral-post rate, 0-1 decimal", "example": 0.8 }, { "name": "burst_text_rate_min", "in": "query", "required": false, "schema": { "description": "Minimum viral-post rate, 0-1 decimal", "title": "Burst Text Rate Min", "type": [ "number", "null" ], "minimum": 0, "maximum": 1 }, "description": "Minimum viral-post rate, 0-1 decimal", "example": 0.1 }, { "name": "cpe_max", "in": "query", "required": false, "schema": { "description": "Maximum expected CPE", "title": "Cpe Max", "type": [ "number", "null" ] }, "description": "Maximum expected CPE", "example": 5 }, { "name": "cpe_min", "in": "query", "required": false, "schema": { "description": "Minimum expected CPE", "title": "Cpe Min", "type": [ "number", "null" ] }, "description": "Minimum expected CPE", "example": 0.1 }, { "name": "cpm_max", "in": "query", "required": false, "schema": { "description": "Maximum expected CPM", "title": "Cpm Max", "type": [ "number", "null" ] }, "description": "Maximum expected CPM", "example": 100 }, { "name": "cpm_min", "in": "query", "required": false, "schema": { "description": "Minimum expected CPM", "title": "Cpm Min", "type": [ "number", "null" ] }, "description": "Minimum expected CPM", "example": 10 }, { "name": "expected_play_max", "in": "query", "required": false, "schema": { "description": "Maximum expected plays", "title": "Expected Play Max", "type": [ "integer", "null" ] }, "description": "Maximum expected plays", "example": 1000000 }, { "name": "expected_play_min", "in": "query", "required": false, "schema": { "description": "Minimum expected plays", "title": "Expected Play Min", "type": [ "integer", "null" ] }, "description": "Minimum expected plays", "example": 100000 }, { "name": "extra_filter", "in": "query", "required": false, "schema": { "description": "Extra profile filters as a JSON-array string; field_name and field_value must be non-empty strings", "title": "Extra Filter", "type": [ "string", "null" ] }, "description": "Extra profile filters as a JSON-array string; field_name and field_value must be non-empty strings", "example": "[{\"field_name\":\"content_theme_labels_180d\",\"field_value\":\"[\\\"生活好物评测\\\"]\"},{\"field_name\":\"watcher_gender_female_rate_v2__ge\",\"field_value\":\"0.6\"},{\"field_name\":\"link_crowd_profile\",\"field_value\":\"[60,55,53,57]\"}]" }, { "name": "fans_max", "in": "query", "required": false, "schema": { "description": "Maximum followers", "title": "Fans Max", "type": [ "integer", "null" ] }, "description": "Maximum followers", "example": 1000000 }, { "name": "fans_min", "in": "query", "required": false, "schema": { "description": "Minimum followers", "title": "Fans Min", "type": [ "integer", "null" ] }, "description": "Minimum followers", "example": 10000 }, { "name": "first_industry_id", "in": "query", "required": false, "schema": { "description": "Industry ID", "title": "First Industry Id", "type": [ "integer", "null" ] }, "description": "Industry ID" }, { "name": "gender", "in": "query", "required": false, "schema": { "description": "Creator gender, 1=male, 2=female", "title": "Gender", "type": [ "integer", "null" ] }, "description": "Creator gender, 1=male, 2=female", "example": 2 }, { "name": "interact_rate_max", "in": "query", "required": false, "schema": { "description": "Maximum interaction rate, 0-1 decimal", "title": "Interact Rate Max", "type": [ "number", "null" ], "minimum": 0, "maximum": 1 }, "description": "Maximum interaction rate, 0-1 decimal", "example": 0.5 }, { "name": "interact_rate_min", "in": "query", "required": false, "schema": { "description": "Minimum interaction rate, 0-1 decimal (e.g. 0.02=2%)", "title": "Interact Rate Min", "type": [ "number", "null" ], "minimum": 0, "maximum": 1 }, "description": "Minimum interaction rate, 0-1 decimal (e.g. 0.02=2%)", "example": 0.02 }, { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Search keyword: nickname, Toutiao ID or content word", "title": "Keyword" }, "description": "Search keyword: nickname, Toutiao ID or content word", "example": "Electronics" }, { "name": "marketing_target", "in": "query", "required": false, "schema": { "type": "integer", "description": "Marketing target", "default": 1, "title": "Marketing Target" }, "description": "Marketing target", "example": 1 }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page number", "default": 1, "title": "Page" }, "description": "Page number", "example": 1 }, { "name": "persona_tags", "in": "query", "required": false, "schema": { "description": "Persona IDs (persona/education/certification/tone). Comma=match any; semicolon=group AND, e.g. `1129,110401;110213`", "title": "Persona Tags", "type": [ "string", "null" ] }, "description": "Persona IDs (persona/education/certification/tone). Comma=match any; semicolon=group AND, e.g. `1129,110401;110213`", "example": "1129,110401" }, { "name": "play_over_rate_max", "in": "query", "required": false, "schema": { "description": "Maximum play-completion rate, 0-1 decimal", "title": "Play Over Rate Max", "type": [ "number", "null" ], "minimum": 0, "maximum": 1 }, "description": "Maximum play-completion rate, 0-1 decimal", "example": 0.9 }, { "name": "play_over_rate_min", "in": "query", "required": false, "schema": { "description": "Minimum play-completion rate, 0-1 decimal", "title": "Play Over Rate Min", "type": [ "number", "null" ], "minimum": 0, "maximum": 1 }, "description": "Minimum play-completion rate, 0-1 decimal", "example": 0.05 }, { "name": "price_max", "in": "query", "required": false, "schema": { "description": "Maximum image-text price; must be provided together with price_type", "title": "Price Max", "type": [ "integer", "null" ], "minimum": 0 }, "description": "Maximum image-text price; must be provided together with price_type", "example": 100000 }, { "name": "price_min", "in": "query", "required": false, "schema": { "description": "Minimum image-text price; must be provided together with price_type", "title": "Price Min", "type": [ "integer", "null" ], "minimum": 0 }, "description": "Minimum image-text price; must be provided together with price_type", "example": 1000 }, { "name": "price_type", "in": "query", "required": false, "schema": { "description": "Toutiao image-text price type, fixed to 11; only used together with price_min/price_max", "title": "Price Type", "anyOf": [ { "description": "Toutiao image-text price type, fixed to 11; only used together with price_min/price_max", "title": "Price Type", "allOf": [ { "type": "integer", "enum": [ 11 ], "title": "XingtuToutiaoPriceType" } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "description": "Toutiao image-text price type, fixed to 11; only used together with price_min/price_max", "example": 11 }, { "name": "sort_field", "in": "query", "required": false, "schema": { "type": "string", "description": "Sort field, default score (comprehensive)", "default": "score", "title": "Sort Field" }, "description": "Sort field, default score (comprehensive)", "example": "score" }, { "name": "sort_type", "in": "query", "required": false, "schema": { "type": "integer", "description": "Sort type: 1=asc, 2=desc", "default": 2, "title": "Sort Type" }, "description": "Sort type: 1=asc, 2=desc", "example": 2 }, { "name": "tag", "in": "query", "required": false, "schema": { "description": "Creator category IDs, comma-separated, e.g. `1,6`", "title": "Tag", "type": [ "string", "null" ] }, "description": "Creator category IDs, comma-separated, e.g. `1,6`", "example": "1" }, { "name": "task_category", "in": "query", "required": false, "schema": { "type": "integer", "description": "Cooperation target", "default": 11, "title": "Task Category" }, "description": "Cooperation target", "example": 11 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:93d1751c61cdc9b5d1dc1f47e95ab93f2d06c5ab11dff0ff24a1dc982f29aa13" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/douyin/xingtu_v2/search_toutiao_creator?burst_text_rate_max=0.8&burst_text_rate_min=0.1&cpe_max=5&cpe_min=0.1&cpm_max=100&cpm_min=10&expected_play_max=1000000&expected_play_min=100000&extra_filter=%5B%7B%22field_name%22%3A%22content_theme_labels_180d%22%2C%22field_value%22%3A%22%5B%5C%22%E7%94%9F%E6%B4%BB%E5%A5%BD%E7%89%A9%E8%AF%84%E6%B5%8B%5C%22%5D%22%7D%2C%7B%22field_name%22%3A%22watcher_gender_female_rate_v2__ge%22%2C%22field_value%22%3A%220.6%22%7D%2C%7B%22field_name%22%3A%22link_crowd_profile%22%2C%22field_value%22%3A%22%5B60%2C55%2C53%2C57%5D%22%7D%5D&fans_max=1000000&fans_min=10000&gender=2&interact_rate_max=0.5&interact_rate_min=0.02&keyword=Electronics&marketing_target=1&page=1&persona_tags=1129%2C110401&play_over_rate_max=0.9&play_over_rate_min=0.05&price_max=100000&price_min=1000&price_type=11&sort_field=score&sort_type=2&tag=1&task_category=11' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-douyin-xingtu_v2-search_toutiao_creator" } }, "/apis/v1/tikhub/hybrid/video_data": { "get": { "description": "Douyin / TikTok.\n\n### Purpose:\n- This endpoint is used to parse data of a single Douyin/TikTok video.\n### Parameters:\n- `url`: Video link, share link, or share text.\n### Returns:\n- `data`: Video data.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_hybrid_video_data", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- `data`: Video data.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "hybrid video_data", "tags": [ "tikhub.hybrid" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "video_data", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "26812febcdbb" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/hybrid/video_data", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_hybrid_video_data", "method": "GET", "path": "/apis/v1/tikhub/hybrid/video_data" }, "parameters": [ { "name": "base64_url", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Base64 encoding URL", "default": false, "title": "Base64 Url" }, "description": "Base64 encoding URL" }, { "name": "minimal", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether to return minimal data", "default": false, "title": "Minimal" }, "description": "Whether to return minimal data" }, { "name": "url", "in": "query", "required": true, "schema": { "type": "string", "title": "Url" }, "example": "https://v.douyin.com/L4FJNR3/", "description": "Video link, share link, or share text." } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:c136c0b01482f6c10817c5ac72b6c2e25912e19e9ba3eee7537cc5976fa96c9b" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/hybrid/video_data?url=https%3A%2F%2Fv.douyin.com%2FL4FJNR3%2F' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-hybrid-video_data" } }, "/apis/v1/tikhub/instagram/v1/fetch_cities": { "get": { "description": "Instagram (v1).\n\n### Purpose\n- Get cities/regions list of specified country\n\n### Parameters\n- country_code: Country code, e.g. US, CN, JP\n- page: Page number, default 1\n\n### Return\n- `country_info`: Country info\n- `city_list`: Cities list\n- `next_page`: Next page number\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v1_fetch_cities", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `country_info`: Country info\n- `city_list`: Cities list\n- `next_page`: Next page number", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram fetch_cities", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v1", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "6964bff83b47" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v1/fetch_cities", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v1_fetch_cities", "method": "GET", "path": "/apis/v1/tikhub/instagram/v1/fetch_cities" }, "parameters": [ { "name": "country_code", "in": "query", "required": true, "schema": { "type": "string", "description": "Country code (e.g. US, CN, JP", "title": "Country Code" }, "description": "Country code (e.g. US, CN, JP", "example": "US" }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "description": "Page number, default 1", "default": 1, "title": "Page" }, "description": "Page number, default 1" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:0a90c22fc58687a995fc928862f64a42da1ca1a0b6a52df372d97dc04208e445" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v1/fetch_cities?country_code=US' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v1-fetch_cities" } }, "/apis/v1/tikhub/instagram/v1/fetch_explore_sections": { "get": { "description": "Instagram (v1).\n\n### Purpose\n- Get all sections and subsections of Instagram explore page\n\n### Return\n- `sections`: Sections list with names, subsections and recommended content\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v1_fetch_explore_sections", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `sections`: Sections list with names, subsections and recommended content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram fetch_explore_sections", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v1", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "c7e0e341cb1c" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v1/fetch_explore_sections", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v1_fetch_explore_sections", "method": "GET", "path": "/apis/v1/tikhub/instagram/v1/fetch_explore_sections" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:65c4fc491f750538cf02c0585a2f1ffdedc93108242eb5261c65b06a12a857c7" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v1-fetch_explore_sections" } }, "/apis/v1/tikhub/instagram/v1/fetch_location_info": { "get": { "description": "Instagram (v1).\n\n### Purpose\n- Get detailed information of specified location\n\n### Parameters\n- location_id: Location ID\n\n### Return\n- `location_info`: Location info including name, address, coordinates etc.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v1_fetch_location_info", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `location_info`: Location info including name, address, coordinates etc.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram fetch_location_info", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v1", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "09a433c5d3cf" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v1/fetch_location_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v1_fetch_location_info", "method": "GET", "path": "/apis/v1/tikhub/instagram/v1/fetch_location_info" }, "parameters": [ { "name": "location_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Location ID", "title": "Location Id" }, "description": "Location ID", "example": "703457703" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:3c87b1a1168bc1ad16d088ebf8ecee39bdce50de37c27ba05f74b6d87c67141c" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v1/fetch_location_info?location_id=703457703' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v1-fetch_location_info" } }, "/apis/v1/tikhub/instagram/v1/fetch_locations": { "get": { "description": "Instagram (v1).\n\n### Purpose\n- Get Instagram locations list of specified city\n\n### Parameters\n- city_id: City ID (from fetch_cities API)\n- page: Page number, default 1\n\n### Return\n- `country_info`: Country info\n- `city_info`: City info\n- `location_list`: Locations list\n- `next_page`: Next page number\n\nAPI references: `fetch_cities` = `GET /tikhub/instagram/v1/fetch_cities` (operationId: `get_tikhub_instagram_v1_fetch_cities`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v1_fetch_locations", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `country_info`: Country info\n- `city_info`: City info\n- `location_list`: Locations list\n- `next_page`: Next page number", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram fetch_locations", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v1", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "69215e56df0f" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v1/fetch_locations", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v1_fetch_locations", "method": "GET", "path": "/apis/v1/tikhub/instagram/v1/fetch_locations" }, "parameters": [ { "name": "city_id", "in": "query", "required": true, "schema": { "type": "string", "description": "City ID (from fetch_cities\n\nAPI references: `fetch_cities` = `GET /tikhub/instagram/v1/fetch_cities` (operationId: `get_tikhub_instagram_v1_fetch_cities`).", "title": "City Id" }, "description": "City ID (from fetch_cities\n\nAPI references: `fetch_cities` = `GET /tikhub/instagram/v1/fetch_cities` (operationId: `get_tikhub_instagram_v1_fetch_cities`).", "example": "c2791472" }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "description": "Page number, default 1", "default": 1, "title": "Page" }, "description": "Page number, default 1" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e35a3388200e1aebe365a8b12758e7f56c810dc2c725438496c94477134d89af" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v1/fetch_locations?city_id=c2791472' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v1-fetch_locations" } }, "/apis/v1/tikhub/instagram/v1/fetch_post_by_id": { "get": { "description": "Instagram (v1).\n\n### Purpose\n- Get single post details by ID\n\n### Parameters\n- post_id: Post ID\n\n### Return\n- Post details object with media, likes, comments etc.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v1_fetch_post_by_id", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Post details object with media, likes, comments etc.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram fetch_post_by_id", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v1", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "9908969184ba" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v1/fetch_post_by_id", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v1_fetch_post_by_id", "method": "GET", "path": "/apis/v1/tikhub/instagram/v1/fetch_post_by_id" }, "parameters": [ { "name": "post_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Post ID", "title": "Post Id" }, "description": "Post ID", "example": "3742637871112032100" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:424cd9bab4232bd33c3ab2e5336e1d6a2e68b4ce0ae7acb1007f488d84a125cb" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v1/fetch_post_by_id?post_id=3742637871112032100' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v1-fetch_post_by_id" } }, "/apis/v1/tikhub/instagram/v1/fetch_post_by_url": { "get": { "description": "Instagram (v1).\n\n### Purpose\n- Get single post details by URL\n\n### Parameters\n- post_url: Post URL\n\n### Return\n- Post details object with media, likes, comments etc.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v1_fetch_post_by_url", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Post details object with media, likes, comments etc.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram fetch_post_by_url", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v1", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "94bd76fd53b5" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v1/fetch_post_by_url", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v1_fetch_post_by_url", "method": "GET", "path": "/apis/v1/tikhub/instagram/v1/fetch_post_by_url" }, "parameters": [ { "name": "post_url", "in": "query", "required": true, "schema": { "type": "string", "description": "Post URL", "title": "Post Url" }, "description": "Post URL", "example": "https://www.instagram.com/p/DPwhVB-jo9k/" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:424cd9bab4232bd33c3ab2e5336e1d6a2e68b4ce0ae7acb1007f488d84a125cb" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v1/fetch_post_by_url?post_url=https%3A%2F%2Fwww.instagram.com%2Fp%2FDPwhVB-jo9k%2F' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v1-fetch_post_by_url" } }, "/apis/v1/tikhub/instagram/v1/fetch_related_profiles": { "get": { "description": "Instagram (v1).\n\n### Purpose\n- Get related/similar user recommendations\n\n### Parameters\n- user_id: Instagram user ID\n\n### Return\n- GraphQL style response with `data.user.edge_related_profiles`\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v1_fetch_related_profiles", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- GraphQL style response with `data.user.edge_related_profiles`", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram fetch_related_profiles", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v1", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "e3b29d16c13a" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v1/fetch_related_profiles", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v1_fetch_related_profiles", "method": "GET", "path": "/apis/v1/tikhub/instagram/v1/fetch_related_profiles" }, "parameters": [ { "name": "user_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Instagram user ID", "title": "User Id" }, "description": "Instagram user ID", "example": "25025320" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:f8504fd6262e66db88e62228b7c7334a2a3859f204c01c73b5ef60ce3cd1b544" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v1/fetch_related_profiles?user_id=25025320' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v1-fetch_related_profiles" } }, "/apis/v1/tikhub/instagram/v1/fetch_search": { "get": { "description": "Instagram (v1).\n\n### Purpose\n- Search users, hashtags or places on Instagram\n\n### Parameters\n- query: Search keyword\n- select: Filter type (optional)\n - `users`: Only return users\n - `hashtags`: Only return hashtags\n - `places`: Only return places\n - omit: Return all types\n\n### Return\n- `users`: Users list\n- `hashtags`: Hashtags list\n- `places`: Places list\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v1_fetch_search", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `users`: Users list\n- `hashtags`: Hashtags list\n- `places`: Places list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram fetch_search", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v1", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "70eb2a62d6e2" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v1/fetch_search", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v1_fetch_search", "method": "GET", "path": "/apis/v1/tikhub/instagram/v1/fetch_search" }, "parameters": [ { "name": "query", "in": "query", "required": true, "schema": { "type": "string", "description": "Search keyword", "title": "Query" }, "description": "Search keyword", "example": "taylorswift" }, { "name": "select", "in": "query", "required": false, "schema": { "type": "string", "description": "Filter type (optional)\n - `users`: Only return users\n - `hashtags`: Only return hashtags\n - `places`: Only return places\n - omit: Return all types", "title": "Select" }, "description": "Filter type (optional)\n - `users`: Only return users\n - `hashtags`: Only return hashtags\n - `places`: Only return places\n - omit: Return all types" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:3ae5790d8de14d124538fe304b554dd5588081490262c0d571b28ea1d682c19d" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v1/fetch_search?query=taylorswift' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v1-fetch_search" } }, "/apis/v1/tikhub/instagram/v1/fetch_section_posts": { "get": { "description": "Instagram (v1).\n\n### Purpose\n- Get posts under specific explore section\n\n### Parameters\n- section_id: Section ID (from fetch_explore_sections API)\n- count: Count per page, default 20\n- max_id: Pagination cursor, omit for first request\n\n### Return\n- `section_name`: Section name\n- `items`: Posts list\n- `subsections`: Subsections list\n- `max_id`: Next page cursor\n- `more_available`: Whether more data available\n\nAPI references: `fetch_explore_sections` = `GET /tikhub/instagram/v1/fetch_explore_sections` (operationId: `get_tikhub_instagram_v1_fetch_explore_sections`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v1_fetch_section_posts", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `section_name`: Section name\n- `items`: Posts list\n- `subsections`: Subsections list\n- `max_id`: Next page cursor\n- `more_available`: Whether more data available", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram fetch_section_posts", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v1", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "fcf4f49984c8" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v1/fetch_section_posts", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v1_fetch_section_posts", "method": "GET", "path": "/apis/v1/tikhub/instagram/v1/fetch_section_posts" }, "parameters": [ { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 50, "minimum": 1, "description": "Count per page, default 20", "default": 20, "title": "Count" }, "description": "Count per page, default 20" }, { "name": "max_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination cursor for next page", "title": "Max Id" }, "description": "Pagination cursor for next page" }, { "name": "section_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Section ID (from fetch_explore_sections\n\nAPI references: `fetch_explore_sections` = `GET /tikhub/instagram/v1/fetch_explore_sections` (operationId: `get_tikhub_instagram_v1_fetch_explore_sections`).", "title": "Section Id" }, "description": "Section ID (from fetch_explore_sections\n\nAPI references: `fetch_explore_sections` = `GET /tikhub/instagram/v1/fetch_explore_sections` (operationId: `get_tikhub_instagram_v1_fetch_explore_sections`).", "example": "10156104410190727" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:a9e43653b754122e1bb8ced47ca666d6fe2904c1a8d47a0afcdc7571c32acd1a" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v1/fetch_section_posts?section_id=10156104410190727' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v1-fetch_section_posts" } }, "/apis/v1/tikhub/instagram/v1/fetch_user_about_info": { "get": { "description": "Instagram (v1).\n\n### Purpose\n- Get user's \"About This Account\" information\n- Contains account creation date, location, verification status and more\n\n### Parameters\n- user_id: Instagram user ID (numeric format)\n\n### Return\n- `status`: Request status\n- `user_id`: User ID\n- `username`: Username\n- `profile_pic_url`: Profile picture URL\n- `is_verified`: Whether verified\n- `date_joined`: Account creation date (e.g., \"June 2012\")\n- `account_based_in`: Account location (e.g., \"United States\")\n- `verified_date`: Verification date (e.g., \"August 2017\", None if not verified)\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v1_fetch_user_about_info", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `status`: Request status\n- `user_id`: User ID\n- `username`: Username\n- `profile_pic_url`: Profile picture URL\n- `is_verified`: Whether verified\n- `date_joined`: Account creation date (e.g., \"June 2012\")\n- `account_based_in`: Account location (e.g., \"United States\")\n- `verified_date`: Verification date (e.g., \"August 2017\", None if not verified)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram fetch_user_about_info", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v1", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "f6c28f2b060e" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v1/fetch_user_about_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v1_fetch_user_about_info", "method": "GET", "path": "/apis/v1/tikhub/instagram/v1/fetch_user_about_info" }, "parameters": [ { "name": "user_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Instagram user ID", "title": "User Id" }, "description": "Instagram user ID", "example": "182988865" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:3d2441e6208f241a136c1279700ac97a6bf57b78abcf69eb5db495442aa37cbf" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v1/fetch_user_about_info?user_id=182988865' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v1-fetch_user_about_info" } }, "/apis/v1/tikhub/instagram/v1/fetch_user_info_by_id": { "get": { "description": "Instagram (v1).\n\n### Purpose\n- Get user data by Instagram user ID\n\n### Parameters\n- user_id: Instagram user ID\n\n### Return\n- User information object with timeline media, HD avatar and complete data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v1_fetch_user_info_by_id", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- User information object with timeline media, HD avatar and complete data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram fetch_user_info_by_id", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v1", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "f82c8cbcbf21" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v1/fetch_user_info_by_id", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v1_fetch_user_info_by_id", "method": "GET", "path": "/apis/v1/tikhub/instagram/v1/fetch_user_info_by_id" }, "parameters": [ { "name": "user_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Instagram user ID", "title": "User Id" }, "description": "Instagram user ID", "example": "25025320" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:8ebd3e458828c3ea732db90249e2d4ef671273f2619c3183730bfda19f689f66" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v1/fetch_user_info_by_id?user_id=25025320' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v1-fetch_user_info_by_id" } }, "/apis/v1/tikhub/instagram/v1/fetch_user_info_by_username": { "get": { "description": "Instagram (v1).\n\n### Purpose\n- Get user data by Instagram username\n\n### Parameters\n- username: Instagram username\n\n### Return\n- User information object with main fields:\n - `id`: User ID\n - `username`: Username\n - `full_name`: Full name\n - `biography`: Bio\n - `bio_links`: Bio links list\n - `edge_followed_by`: Followers count {count: xxx}\n - `edge_follow`: Following count {count: xxx}\n - `profile_pic_url`: Profile picture URL\n - `profile_pic_url_hd`: HD profile picture URL\n - `is_private`: Whether account is private\n - `is_verified`: Whether account is verified\n - `external_url`: External link\n - `is_business_account`: Whether business account\n - `is_professional_account`: Whether professional account\n - `highlight_reel_count`: Highlights count\n - `edge_owner_to_timeline_media`: Timeline media (contains recent posts)\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v1_fetch_user_info_by_username", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- User information object with main fields:\n - `id`: User ID\n - `username`: Username\n - `full_name`: Full name\n - `biography`: Bio\n - `bio_links`: Bio links list\n - `edge_followed_by`: Followers count {count: xxx}\n - `edge_follow`: Following count {count: xxx}\n - `profile_pic_url`: Profile picture URL\n - `profile_pic_url_hd`: HD profile picture URL\n - `is_private`: Whether account is private\n - `is_verified`: Whether account is verified\n - `external_url`: External link\n - `is_business_account`: Whether business account\n - `is_professional_account`: Whether professional account\n - `highlight_reel_count`: Highlights count\n - `edge_owner_to_timeline_media`: Timeline media (contains recent posts)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram fetch_user_info_by_username", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v1", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "b02a495bad23" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v1/fetch_user_info_by_username", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v1_fetch_user_info_by_username", "method": "GET", "path": "/apis/v1/tikhub/instagram/v1/fetch_user_info_by_username" }, "parameters": [ { "name": "username", "in": "query", "required": true, "schema": { "type": "string", "description": "Instagram username", "title": "Username" }, "description": "Instagram username", "example": "instagram" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:7907ef82cdc37d2287bb0e2ad5292542d40cba6da59b4bd0e76b5a06ce82e273" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v1/fetch_user_info_by_username?username=instagram' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v1-fetch_user_info_by_username" } }, "/apis/v1/tikhub/instagram/v1/fetch_user_reposts": { "get": { "description": "Instagram (v1).\n\n### Purpose\n- Get user reposts/shares list with pagination\n\n### Parameters\n- user_id: Instagram user ID\n- max_id: Pagination cursor, omit for first request\n\n### Return\n- `items`: Reposts list\n- `more_available`: Whether more data available\n- `next_max_id`: Next page cursor\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v1_fetch_user_reposts", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `items`: Reposts list\n- `more_available`: Whether more data available\n- `next_max_id`: Next page cursor", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram fetch_user_reposts", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v1", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "ec2607fdb311" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v1/fetch_user_reposts", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v1_fetch_user_reposts", "method": "GET", "path": "/apis/v1/tikhub/instagram/v1/fetch_user_reposts" }, "parameters": [ { "name": "max_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination cursor for next page", "title": "Max Id" }, "description": "Pagination cursor for next page" }, { "name": "user_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Instagram user ID", "title": "User Id" }, "description": "Instagram user ID", "example": "25025320" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:ac8d73f90022df81e85ba9ddbfe0ddefeaa0c9d200bdbdb3f0ab3fab1f318c5f" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v1/fetch_user_reposts?user_id=25025320' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v1-fetch_user_reposts" } }, "/apis/v1/tikhub/instagram/v2/fetch_comment_replies": { "get": { "description": "Instagram (v2).\n\n### Purpose\n- Get list of replies to a comment\n- Need to get comment ID from fetch_post_comments first\n- Support pagination\n\n### Parameters\n- code_or_url: Post shortcode or full URL\n- comment_id: Comment ID\n- pagination_token: Pagination token from previous response\n\n### Return\n- `data.items`: List of replies\n- `pagination_token`: Next page token\n\nAPI references: `fetch_post_comments` = `GET /tikhub/instagram/v2/fetch_post_comments` (operationId: `get_tikhub_instagram_v2_fetch_post_comments`).\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v2_fetch_comment_replies", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `data.items`: List of replies\n- `pagination_token`: Next page token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram fetch_comment_replies", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "353daf5406da" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v2/fetch_comment_replies", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v2_fetch_comment_replies", "method": "GET", "path": "/apis/v1/tikhub/instagram/v2/fetch_comment_replies" }, "parameters": [ { "name": "code_or_url", "in": "query", "required": true, "schema": { "type": "string", "description": "Post shortcode or URL", "title": "Code Or Url" }, "description": "Post shortcode or URL", "example": "DRhvwVLAHAG" }, { "name": "comment_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Comment ID Obtain the parent comment ID from the post-comments response. Call `GET /tikhub/instagram/v2/fetch_post_comments` (operationId: `get_tikhub_instagram_v2_fetch_post_comments`).", "title": "Comment Id" }, "description": "Comment ID Obtain the parent comment ID from the post-comments response. Call `GET /tikhub/instagram/v2/fetch_post_comments` (operationId: `get_tikhub_instagram_v2_fetch_post_comments`).", "example": "18067775592012345" }, { "name": "pagination_token", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination token", "title": "Pagination Token" }, "description": "Pagination token" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:16f415eb0642b030947dc407487acdee429d733eb9efeb32d011818275dcbce2" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v2/fetch_comment_replies?code_or_url=DRhvwVLAHAG&comment_id=18067775592012345' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v2-fetch_comment_replies" } }, "/apis/v1/tikhub/instagram/v2/fetch_hashtag_posts": { "get": { "description": "Instagram (v2).\n\n### Purpose\n- Get posts under specified hashtag\n- Support filtering by top, recent, or reels only\n- Support pagination\n\n### Parameters\n- keyword: Hashtag keyword (without #)\n- feed_type: Feed type \"top\", \"recent\", or \"reels\", default top\n- pagination_token: Pagination token from previous response\n\n### Return\n- `data.items`: List of posts\n- `pagination_token`: Next page token\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v2_fetch_hashtag_posts", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `data.items`: List of posts\n- `pagination_token`: Next page token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram fetch_hashtag_posts", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "918ceed86c16" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v2/fetch_hashtag_posts", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v2_fetch_hashtag_posts", "method": "GET", "path": "/apis/v1/tikhub/instagram/v2/fetch_hashtag_posts" }, "parameters": [ { "name": "feed_type", "in": "query", "required": false, "schema": { "type": "string", "description": "Feed type: top, recent, or reels", "default": "top", "title": "Feed Type" }, "description": "Feed type: top, recent, or reels" }, { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Hashtag keyword (without #", "title": "Keyword" }, "description": "Hashtag keyword (without #", "example": "cat" }, { "name": "pagination_token", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination token", "title": "Pagination Token" }, "description": "Pagination token" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:436ac60db610d532bf7640ced54a6c4902fef32521c0bfdcda63ba7a4be9d4c5" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v2/fetch_hashtag_posts?keyword=cat' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v2-fetch_hashtag_posts" } }, "/apis/v1/tikhub/instagram/v2/fetch_highlight_stories": { "get": { "description": "Instagram (v2).\n\n### Purpose\n- Get all stories in a specific highlight\n- Need to get highlight ID from fetch_user_highlights first\n\n### Parameters\n- highlight_id: Highlight ID (with or without \"highlight:\" prefix)\n\n### Return\n- `data.items`: List of stories with image/video URLs, publish time, etc.\n\nAPI references: `fetch_user_highlights` = `GET /tikhub/instagram/v2/fetch_user_highlights` (operationId: `get_tikhub_instagram_v2_fetch_user_highlights`).\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v2_fetch_highlight_stories", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `data.items`: List of stories with image/video URLs, publish time, etc.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram fetch_highlight_stories", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "81f1b930e198" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v2/fetch_highlight_stories", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v2_fetch_highlight_stories", "method": "GET", "path": "/apis/v1/tikhub/instagram/v2/fetch_highlight_stories" }, "parameters": [ { "name": "highlight_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Highlight ID (with or without \"highlight:\" prefix) Obtain a highlight ID from the user-highlights response. Call `GET /tikhub/instagram/v2/fetch_user_highlights` (operationId: `get_tikhub_instagram_v2_fetch_user_highlights`).", "title": "Highlight Id" }, "description": "Highlight ID (with or without \"highlight:\" prefix) Obtain a highlight ID from the user-highlights response. Call `GET /tikhub/instagram/v2/fetch_user_highlights` (operationId: `get_tikhub_instagram_v2_fetch_user_highlights`).", "example": "17895069621772257" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:55942a1d15befe9f0ea5de7853843f28750a4fa017f2046a6f5f9ca3544a7ca6" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v2/fetch_highlight_stories?highlight_id=17895069621772257' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v2-fetch_highlight_stories" } }, "/apis/v1/tikhub/instagram/v2/fetch_location_posts": { "get": { "description": "Instagram (v2).\n\n### Purpose\n- Get posts at specified location\n- Location ID can be obtained from search_locations\n- Support pagination\n\n### Parameters\n- location_id: Location ID\n- pagination_token: Pagination token from previous response\n\n### Return\n- `data.items`: List of posts\n- `pagination_token`: Next page token\n\nAPI references: `search_locations` = `GET /tikhub/instagram/v2/search_locations` (operationId: `get_tikhub_instagram_v2_search_locations`).\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v2_fetch_location_posts", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `data.items`: List of posts\n- `pagination_token`: Next page token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram fetch_location_posts", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "aeec706031d7" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v2/fetch_location_posts", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v2_fetch_location_posts", "method": "GET", "path": "/apis/v1/tikhub/instagram/v2/fetch_location_posts" }, "parameters": [ { "name": "location_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Location ID Obtain the location ID from location-search results. Call `GET /tikhub/instagram/v2/search_locations` (operationId: `get_tikhub_instagram_v2_search_locations`).", "title": "Location Id" }, "description": "Location ID Obtain the location ID from location-search results. Call `GET /tikhub/instagram/v2/search_locations` (operationId: `get_tikhub_instagram_v2_search_locations`).", "example": "331004901" }, { "name": "pagination_token", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination token", "title": "Pagination Token" }, "description": "Pagination token" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:436ac60db610d532bf7640ced54a6c4902fef32521c0bfdcda63ba7a4be9d4c5" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v2/fetch_location_posts?location_id=331004901' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v2-fetch_location_posts" } }, "/apis/v1/tikhub/instagram/v2/fetch_music_posts": { "get": { "description": "Instagram (v2).\n\n### Purpose\n- Get posts using specified music\n- Audio ID can be obtained from post details\n- Support pagination\n\n### Parameters\n- audio_canonical_id: Audio ID\n- pagination_token: Pagination token from previous response\n\n### Return\n- `data.items`: List of posts\n- `pagination_token`: Next page token\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v2_fetch_music_posts", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `data.items`: List of posts\n- `pagination_token`: Next page token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram fetch_music_posts", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "56c8b5d04ec2" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v2/fetch_music_posts", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v2_fetch_music_posts", "method": "GET", "path": "/apis/v1/tikhub/instagram/v2/fetch_music_posts" }, "parameters": [ { "name": "audio_canonical_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Audio ID", "title": "Audio Canonical Id" }, "description": "Audio ID", "example": "564058920086577" }, { "name": "pagination_token", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination token", "title": "Pagination Token" }, "description": "Pagination token" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:436ac60db610d532bf7640ced54a6c4902fef32521c0bfdcda63ba7a4be9d4c5" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v2/fetch_music_posts?audio_canonical_id=564058920086577' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v2-fetch_music_posts" } }, "/apis/v1/tikhub/instagram/v2/fetch_post_comments": { "get": { "description": "Instagram (v2).\n\n### Purpose\n- Get list of comments on the post\n- Support sorting by recent or popular\n- Support pagination\n\n### Parameters\n- code_or_url: Post shortcode or full URL\n- sort_by: Sort by \"recent\" or \"popular\", default recent\n- pagination_token: Pagination token from previous response\n\n### Return\n- `data.items`: List of comments\n- `pagination_token`: Next page token\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v2_fetch_post_comments", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `data.items`: List of comments\n- `pagination_token`: Next page token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram fetch_post_comments", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "80b2007d1deb" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v2/fetch_post_comments", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v2_fetch_post_comments", "method": "GET", "path": "/apis/v1/tikhub/instagram/v2/fetch_post_comments" }, "parameters": [ { "name": "code_or_url", "in": "query", "required": true, "schema": { "type": "string", "description": "Post shortcode or URL", "title": "Code Or Url" }, "description": "Post shortcode or URL", "example": "DRhvwVLAHAG" }, { "name": "pagination_token", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination token", "default": "", "title": "Pagination Token" }, "description": "Pagination token", "example": "" }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "description": "Sort by: recent or popular", "default": "recent", "title": "Sort By" }, "description": "Sort by: recent or popular", "example": "recent" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:d4ebc4d424a287ac323202a042bef51f08f3c8eb4c402218bfc0401ad2b4ada4" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v2/fetch_post_comments?code_or_url=DRhvwVLAHAG&pagination_token=&sort_by=recent' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v2-fetch_post_comments" } }, "/apis/v1/tikhub/instagram/v2/fetch_post_info": { "get": { "description": "Instagram (v2).\n\n### Purpose\n- Get detailed information of Instagram post\n- Support shortcode or full URL\n\n### Parameters\n- code_or_url: Post shortcode or full URL\n\n### Return\n- `data`: Post details including media, caption, likes, comments, etc.\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v2_fetch_post_info", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `data`: Post details including media, caption, likes, comments, etc.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram fetch_post_info", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "7e689b9843af" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v2/fetch_post_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v2_fetch_post_info", "method": "GET", "path": "/apis/v1/tikhub/instagram/v2/fetch_post_info" }, "parameters": [ { "name": "code_or_url", "in": "query", "required": true, "schema": { "type": "string", "description": "Post shortcode or URL", "title": "Code Or Url" }, "description": "Post shortcode or URL", "example": "DRhvwVLAHAG" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:8c2d0eb4b6604c21806e2e55880823f78ddb747001ca879822f640b1f2eb11e6" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v2/fetch_post_info?code_or_url=DRhvwVLAHAG' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v2-fetch_post_info" } }, "/apis/v1/tikhub/instagram/v2/fetch_post_likes": { "get": { "description": "Instagram (v2).\n\n### Purpose\n- Get list of users who liked the post\n- Support pagination\n\n### Parameters\n- code_or_url: Post shortcode or full URL\n- end_cursor: Pagination cursor from previous response\n\n### Return\n- `data.items`: List of users who liked\n- `end_cursor`: Next page cursor\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v2_fetch_post_likes", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `data.items`: List of users who liked\n- `end_cursor`: Next page cursor", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram fetch_post_likes", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "0ea74855d711" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v2/fetch_post_likes", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v2_fetch_post_likes", "method": "GET", "path": "/apis/v1/tikhub/instagram/v2/fetch_post_likes" }, "parameters": [ { "name": "code_or_url", "in": "query", "required": true, "schema": { "type": "string", "description": "Post shortcode or URL", "title": "Code Or Url" }, "description": "Post shortcode or URL", "example": "DRhvwVLAHAG" }, { "name": "end_cursor", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination cursor", "title": "End Cursor" }, "description": "Pagination cursor" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:2265531c50f59ebb0c792811cd8893a31994b236f37ade2680ffb33bb8d41a98" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v2/fetch_post_likes?code_or_url=DRhvwVLAHAG' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v2-fetch_post_likes" } }, "/apis/v1/tikhub/instagram/v2/fetch_similar_users": { "get": { "description": "Instagram (v2).\n\n### Purpose\n- Get recommended similar users\n- Based on Instagram's recommendation algorithm\n\n### Parameters\n- username: Username (either username or user_id required)\n- user_id: User ID (either username or user_id required)\n\n### Return\n- `data.items`: List of similar users\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v2_fetch_similar_users", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `data.items`: List of similar users", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram fetch_similar_users", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "80baedf3de2f" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v2/fetch_similar_users", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v2_fetch_similar_users", "method": "GET", "path": "/apis/v1/tikhub/instagram/v2/fetch_similar_users" }, "parameters": [ { "name": "user_id", "in": "query", "required": false, "schema": { "type": "string", "description": "User ID (either username or user_id required)", "title": "User Id" }, "description": "User ID (either username or user_id required)", "example": "18527" }, { "name": "username", "in": "query", "required": false, "schema": { "type": "string", "description": "Username (either username or user_id required)", "title": "Username" }, "description": "Username (either username or user_id required)", "example": "instagram" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:21904542840a961893d04b7ccd4d29d957249771a015387bb023af02beb51955" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v2-fetch_similar_users" } }, "/apis/v1/tikhub/instagram/v2/fetch_user_followers": { "get": { "description": "Instagram (v2).\n\n### Purpose\n- Get list of followers of Instagram user\n- Support pagination\n\n### Parameters\n- username: Username (either username or user_id required)\n- user_id: User ID (either username or user_id required)\n- pagination_token: Pagination token from previous response\n\n### Return\n- `data.items`: List of followers\n- `pagination_token`: Next page token\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v2_fetch_user_followers", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `data.items`: List of followers\n- `pagination_token`: Next page token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram fetch_user_followers", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "8278c74253d3" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v2/fetch_user_followers", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v2_fetch_user_followers", "method": "GET", "path": "/apis/v1/tikhub/instagram/v2/fetch_user_followers" }, "parameters": [ { "name": "pagination_token", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination token", "title": "Pagination Token" }, "description": "Pagination token" }, { "name": "user_id", "in": "query", "required": false, "schema": { "type": "string", "description": "User ID (either username or user_id required)", "title": "User Id" }, "description": "User ID (either username or user_id required)", "example": "18527" }, { "name": "username", "in": "query", "required": false, "schema": { "type": "string", "description": "Username (either username or user_id required)", "title": "Username" }, "description": "Username (either username or user_id required)", "example": "instagram" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:b8a1e4795c4b501f5d03bc5c6faba60269afe81265385e6c5f796fb74f53dcfe" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v2-fetch_user_followers" } }, "/apis/v1/tikhub/instagram/v2/fetch_user_following": { "get": { "description": "Instagram (v2).\n\n### Purpose\n- Get list of users that Instagram user is following\n- Support pagination\n\n### Parameters\n- username: Username (either username or user_id required)\n- user_id: User ID (either username or user_id required)\n- pagination_token: Pagination token from previous response\n\n### Return\n- `data.items`: List of following\n- `pagination_token`: Next page token\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v2_fetch_user_following", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `data.items`: List of following\n- `pagination_token`: Next page token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram fetch_user_following", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "85a0371f874b" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v2/fetch_user_following", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v2_fetch_user_following", "method": "GET", "path": "/apis/v1/tikhub/instagram/v2/fetch_user_following" }, "parameters": [ { "name": "pagination_token", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination token", "title": "Pagination Token" }, "description": "Pagination token" }, { "name": "user_id", "in": "query", "required": false, "schema": { "type": "string", "description": "User ID (either username or user_id required)", "title": "User Id" }, "description": "User ID (either username or user_id required)", "example": "18527" }, { "name": "username", "in": "query", "required": false, "schema": { "type": "string", "description": "Username (either username or user_id required)", "title": "Username" }, "description": "Username (either username or user_id required)", "example": "instagram" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:37ba2e29f1db92842905ce9eae84d49c674b01c07a797c850b5867a0ac58c7f6" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v2-fetch_user_following" } }, "/apis/v1/tikhub/instagram/v2/fetch_user_highlights": { "get": { "description": "Instagram (v2).\n\n### Purpose\n- Get Instagram user's highlights list\n- Highlights are saved story collections\n\n### Parameters\n- username: Username (either username or user_id required)\n- user_id: User ID (either username or user_id required)\n\n### Return\n- `data.items`: List of highlights with ID, title, cover, etc.\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v2_fetch_user_highlights", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `data.items`: List of highlights with ID, title, cover, etc.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram fetch_user_highlights", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "40ff877bcda0" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v2/fetch_user_highlights", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v2_fetch_user_highlights", "method": "GET", "path": "/apis/v1/tikhub/instagram/v2/fetch_user_highlights" }, "parameters": [ { "name": "user_id", "in": "query", "required": false, "schema": { "type": "string", "description": "User ID (either username or user_id required)", "title": "User Id" }, "description": "User ID (either username or user_id required)", "example": "18527" }, { "name": "username", "in": "query", "required": false, "schema": { "type": "string", "description": "Username (either username or user_id required)", "title": "Username" }, "description": "Username (either username or user_id required)", "example": "instagram" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:1415f3e53e856fe190546e94a32d14bc7a00d0978732eeb68f110711f930a1bf" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v2-fetch_user_highlights" } }, "/apis/v1/tikhub/instagram/v2/fetch_user_info": { "get": { "description": "Instagram (v2).\n\n### Purpose\n- Get detailed Instagram user information\n- Support query by username or user ID\n\n### Parameters\n- username: Username (either username or user_id required)\n- user_id: User ID (either username or user_id required)\n\n### Return\n- `data`: User info including username, avatar, bio, followers, following, posts count, etc.\n- This endpoint returns user's about info including country, join date, verification status, etc.\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v2_fetch_user_info", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `data`: User info including username, avatar, bio, followers, following, posts count, etc.\n- This endpoint returns user's about info including country, join date, verification status, etc.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram fetch_user_info", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "ed7618ce4396" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v2/fetch_user_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v2_fetch_user_info", "method": "GET", "path": "/apis/v1/tikhub/instagram/v2/fetch_user_info" }, "parameters": [ { "name": "user_id", "in": "query", "required": false, "schema": { "type": "string", "description": "User ID (either username or user_id required)", "title": "User Id" }, "description": "User ID (either username or user_id required)", "example": "18527" }, { "name": "username", "in": "query", "required": false, "schema": { "type": "string", "description": "Username (either username or user_id required)", "title": "Username" }, "description": "Username (either username or user_id required)", "example": "instagram" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:afa1c0ec91832da1a46d021e9891e47c91fca5542eb64ed55364c8975384a7e3" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v2-fetch_user_info" } }, "/apis/v1/tikhub/instagram/v2/fetch_user_posts": { "get": { "description": "Instagram (v2).\n\n### Purpose\n- Get list of posts published by Instagram user\n- Support pagination\n\n### Parameters\n- username: Username (either username or user_id required)\n- user_id: User ID (either username or user_id required)\n- pagination_token: Pagination token from previous response\n\n### Return\n- `data.items`: List of posts\n- `pagination_token`: Next page token\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v2_fetch_user_posts", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `data.items`: List of posts\n- `pagination_token`: Next page token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram fetch_user_posts", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "400634697837" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v2/fetch_user_posts", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v2_fetch_user_posts", "method": "GET", "path": "/apis/v1/tikhub/instagram/v2/fetch_user_posts" }, "parameters": [ { "name": "pagination_token", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination token", "title": "Pagination Token" }, "description": "Pagination token" }, { "name": "user_id", "in": "query", "required": false, "schema": { "type": "string", "description": "User ID (either username or user_id required)", "title": "User Id" }, "description": "User ID (either username or user_id required)", "example": "18527" }, { "name": "username", "in": "query", "required": false, "schema": { "type": "string", "description": "Username (either username or user_id required)", "title": "Username" }, "description": "Username (either username or user_id required)", "example": "instagram" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:436ac60db610d532bf7640ced54a6c4902fef32521c0bfdcda63ba7a4be9d4c5" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v2-fetch_user_posts" } }, "/apis/v1/tikhub/instagram/v2/fetch_user_reels": { "get": { "description": "Instagram (v2).\n\n### Purpose\n- Get list of Reels published by Instagram user\n- Support pagination\n\n### Parameters\n- username: Username (either username or user_id required)\n- user_id: User ID (either username or user_id required)\n- pagination_token: Pagination token from previous response\n\n### Return\n- `data.items`: List of reels\n- `pagination_token`: Next page token\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v2_fetch_user_reels", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `data.items`: List of reels\n- `pagination_token`: Next page token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram fetch_user_reels", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "d0df17703955" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v2/fetch_user_reels", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v2_fetch_user_reels", "method": "GET", "path": "/apis/v1/tikhub/instagram/v2/fetch_user_reels" }, "parameters": [ { "name": "pagination_token", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination token", "title": "Pagination Token" }, "description": "Pagination token" }, { "name": "user_id", "in": "query", "required": false, "schema": { "type": "string", "description": "User ID (either username or user_id required)", "title": "User Id" }, "description": "User ID (either username or user_id required)", "example": "18527" }, { "name": "username", "in": "query", "required": false, "schema": { "type": "string", "description": "Username (either username or user_id required)", "title": "Username" }, "description": "Username (either username or user_id required)", "example": "instagram" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:015bc92667e2cc8354f4fe639e5b7e90daa1c537d017bdfa1f58824f4fb45608" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v2-fetch_user_reels" } }, "/apis/v1/tikhub/instagram/v2/fetch_user_stories": { "get": { "description": "Instagram (v2).\n\n### Purpose\n- Get current stories published by Instagram user\n- Stories expire after 24 hours\n\n### Parameters\n- username: Username (either username or user_id required)\n- user_id: User ID (either username or user_id required)\n\n### Return\n- `data.items`: List of stories with image/video URLs, publish time, etc.\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v2_fetch_user_stories", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `data.items`: List of stories with image/video URLs, publish time, etc.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram fetch_user_stories", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "1dd49fcdf809" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v2/fetch_user_stories", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v2_fetch_user_stories", "method": "GET", "path": "/apis/v1/tikhub/instagram/v2/fetch_user_stories" }, "parameters": [ { "name": "user_id", "in": "query", "required": false, "schema": { "type": "string", "description": "User ID (either username or user_id required)", "title": "User Id" }, "description": "User ID (either username or user_id required)", "example": "18527" }, { "name": "username", "in": "query", "required": false, "schema": { "type": "string", "description": "Username (either username or user_id required)", "title": "Username" }, "description": "Username (either username or user_id required)", "example": "instagram" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:55942a1d15befe9f0ea5de7853843f28750a4fa017f2046a6f5f9ca3544a7ca6" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v2-fetch_user_stories" } }, "/apis/v1/tikhub/instagram/v2/fetch_user_tagged_posts": { "get": { "description": "Instagram (v2).\n\n### Purpose\n- Get posts where the user is tagged by others\n- Support pagination\n\n### Parameters\n- username: Username (either username or user_id required)\n- user_id: User ID (either username or user_id required)\n- pagination_token: Pagination token from previous response\n\n### Return\n- `data.items`: List of posts\n- `pagination_token`: Next page token\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v2_fetch_user_tagged_posts", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `data.items`: List of posts\n- `pagination_token`: Next page token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram fetch_user_tagged_posts", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a393ff04bd56" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v2/fetch_user_tagged_posts", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v2_fetch_user_tagged_posts", "method": "GET", "path": "/apis/v1/tikhub/instagram/v2/fetch_user_tagged_posts" }, "parameters": [ { "name": "pagination_token", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination token", "title": "Pagination Token" }, "description": "Pagination token" }, { "name": "user_id", "in": "query", "required": false, "schema": { "type": "string", "description": "User ID (either username or user_id required)", "title": "User Id" }, "description": "User ID (either username or user_id required)", "example": "18527" }, { "name": "username", "in": "query", "required": false, "schema": { "type": "string", "description": "Username (either username or user_id required)", "title": "Username" }, "description": "Username (either username or user_id required)", "example": "instagram" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:436ac60db610d532bf7640ced54a6c4902fef32521c0bfdcda63ba7a4be9d4c5" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v2-fetch_user_tagged_posts" } }, "/apis/v1/tikhub/instagram/v2/search_locations": { "get": { "description": "Instagram (v2).\n\n### Purpose\n- Search Instagram locations by keyword\n\n### Parameters\n- keyword: Search keyword (location name, city, etc.)\n\n### Return\n- `data.items`: List of locations with name, address, coordinates, etc.\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v2_search_locations", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `data.items`: List of locations with name, address, coordinates, etc.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram search_locations", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "9045c97e4411" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v2/search_locations", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v2_search_locations", "method": "GET", "path": "/apis/v1/tikhub/instagram/v2/search_locations" }, "parameters": [ { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Search keyword (location name, city, etc.)", "title": "Keyword" }, "description": "Search keyword (location name, city, etc.)", "example": "paris" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:51c2a2e8a4de3ad49e4c8e3981badd8a300117b15d54d8280615c0112589f729" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v2/search_locations?keyword=paris' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v2-search_locations" } }, "/apis/v1/tikhub/instagram/v2/search_music": { "get": { "description": "Instagram (v2).\n\n### Purpose\n- Search available music on Instagram by keyword\n\n### Parameters\n- keyword: Search keyword\n\n### Return\n- `data.items`: List of music with title, artist, duration, audio ID, etc.\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v2_search_music", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `data.items`: List of music with title, artist, duration, audio ID, etc.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram search_music", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "b9bc8f8642d2" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v2/search_music", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v2_search_music", "method": "GET", "path": "/apis/v1/tikhub/instagram/v2/search_music" }, "parameters": [ { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Search keyword", "title": "Keyword" }, "description": "Search keyword", "example": "happy" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:98324b3bc340c47e85595790ca9a1db68a9d421b11dc87c7395b0242a268a14e" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v2/search_music?keyword=happy' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v2-search_music" } }, "/apis/v1/tikhub/instagram/v2/search_reels": { "get": { "description": "Instagram (v2).\n\n### Purpose\n- Search Instagram Reels by keyword\n- Support pagination\n\n### Parameters\n- keyword: Search keyword\n- pagination_token: Pagination token from previous response\n\n### Return\n- `data.items`: List of reels\n- `pagination_token`: Next page token\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v2_search_reels", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `data.items`: List of reels\n- `pagination_token`: Next page token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram search_reels", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "8797532b48e4" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v2/search_reels", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v2_search_reels", "method": "GET", "path": "/apis/v1/tikhub/instagram/v2/search_reels" }, "parameters": [ { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Search keyword", "title": "Keyword" }, "description": "Search keyword", "example": "cat" }, { "name": "pagination_token", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination token", "title": "Pagination Token" }, "description": "Pagination token" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:015bc92667e2cc8354f4fe639e5b7e90daa1c537d017bdfa1f58824f4fb45608" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v2/search_reels?keyword=cat' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v2-search_reels" } }, "/apis/v1/tikhub/instagram/v3/bulk_translate_comments": { "get": { "description": "Instagram (v3).\n\n### Purpose\n- Bulk translate Instagram comments\n- Support translating multiple comments at once for better efficiency\n- Comment IDs can be obtained from get_post_comments API\n\n### Parameters\n- comment_ids: Comment ID list, separated by commas, **max 10 IDs**\n - Example: `18099342953509681` (single)\n - Example: `18099342953509681,18099342953509682,18099342953509683` (multiple)\n\n### Note\n- Maximum 10 comment IDs per request, exceeding will return an error\n\n### Return\n- `data.comment_translations`: Translation result mapping\n - key: Comment ID\n - value: Translated text\n\n### Example\n```\ncomment_ids = \"18099342953509681\"\n# comment_ids = \"18099342953509681,18099342953509682\"\n```\n\nAPI references: `get_post_comments` = `GET /tikhub/instagram/v3/get_post_comments` (operationId: `get_tikhub_instagram_v3_get_post_comments`).\n\n\nPublished reference price: $0.008 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v3_bulk_translate_comments", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `data.comment_translations`: Translation result mapping\n - key: Comment ID\n - value: Translated text", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram bulk_translate_comments", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.008, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "d44847c4eee9" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v3/bulk_translate_comments", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v3_bulk_translate_comments", "method": "GET", "path": "/apis/v1/tikhub/instagram/v3/bulk_translate_comments" }, "parameters": [ { "name": "comment_ids", "in": "query", "required": true, "schema": { "type": "string", "description": "Comment ID list, separated by commas, **max 10 IDs**\n - Example: `18099342953509681` (single)\n - Example: `18099342953509681,18099342953509682,18099342953509683` (multiple) Obtain comment IDs from the post-comments response. Call `GET /tikhub/instagram/v3/get_post_comments` (operationId: `get_tikhub_instagram_v3_get_post_comments`).", "title": "Comment Ids", "pattern": "^[^,]*(?:,[^,]*){0,9}$" }, "description": "Comment ID list, separated by commas, **max 10 IDs**\n - Example: `18099342953509681` (single)\n - Example: `18099342953509681,18099342953509682,18099342953509683` (multiple) Obtain comment IDs from the post-comments response. Call `GET /tikhub/instagram/v3/get_post_comments` (operationId: `get_tikhub_instagram_v3_get_post_comments`).", "example": "18099342953509681" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:11bb407a0c2bf4cc31d648b2c9a7c0e8b765fea39d8d6a985cb7f9ea3c7e9837" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v3/bulk_translate_comments?comment_ids=18099342953509681' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v3-bulk_translate_comments" } }, "/apis/v1/tikhub/instagram/v3/extract_shortcode": { "get": { "description": "Instagram (v3).\n\n### Purpose:\n- Extract shortcode from full Instagram post URL\n- Supports /p/, /reel/, /reels/, /tv/ URL formats\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v3_extract_shortcode", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram extract_shortcode", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "382a51aaca14" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v3/extract_shortcode", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v3_extract_shortcode", "method": "GET", "path": "/apis/v1/tikhub/instagram/v3/extract_shortcode" }, "parameters": [ { "name": "url", "in": "query", "required": true, "schema": { "type": "string", "description": "Full Instagram post URL", "title": "Url" }, "description": "Full Instagram post URL", "example": "https://www.instagram.com/p/CrgVBtHrFHm/" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:27bbbea9f88f276297f7b8a4eda303b4ba36d4554a0c305527dbe53091614a42" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v3/extract_shortcode?url=https%3A%2F%2Fwww.instagram.com%2Fp%2FCrgVBtHrFHm%2F' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v3-extract_shortcode" } }, "/apis/v1/tikhub/instagram/v3/general_search": { "get": { "description": "Instagram (v3).\n\n### Purpose\n- Instagram general search API (with pagination)\n- Support pagination via next_max_id to fetch more search results\n- Returns blended results of users, hashtags, places, etc.\n\n### Parameters\n- query: Search keyword\n- next_max_id: Pagination ID, omit for first request, get from previous response `data.next_max_id`\n- rank_token: Rank token, omit for first request, get from previous response `data.rank_token`\n- enable_metadata: Enable metadata\n\n### Return\n- `data.num_results`: Number of results\n- `data.users`: User search results\n- `data.places`: Place search results\n- `data.hashtags`: Hashtag search results\n- `data.next_max_id`: Next page pagination ID (use as next_max_id in next request)\n- `data.rank_token`: Rank token (use as rank_token in next request)\n- `data.has_more`: Whether has more results\n\n### Notes\n- ⚠️ **Known Issue**: General search results may contain duplicate data, this is a known behavior of Instagram API\n- When searching for hashtags, `query` must include the `#` prefix, e.g., use `#fashion` to search for the fashion hashtag\n- The `#` character must be URL-encoded as `%23` in the URL, e.g., `?query=%23fashion`\n- If using an HTTP client library (e.g., requests/httpx), just pass `#fashion` directly and the library will handle encoding automatically\n\n### Pagination usage\n1. First request: Only pass `query` parameter\n2. Get `next_max_id` and `rank_token` from response\n3. Next request: Pass `query`, `next_max_id` and `rank_token`\n4. Repeat steps 2-3 until `has_more` is false\n\n### Example\n```\nquery = \"justin\"\n```\n\n\nPublished reference price: $0.008 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v3_general_search", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `data.num_results`: Number of results\n- `data.users`: User search results\n- `data.places`: Place search results\n- `data.hashtags`: Hashtag search results\n- `data.next_max_id`: Next page pagination ID (use as next_max_id in next request)\n- `data.rank_token`: Rank token (use as rank_token in next request)\n- `data.has_more`: Whether has more results", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram general_search", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.008, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "bfe434f98911" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v3/general_search", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v3_general_search", "method": "GET", "path": "/apis/v1/tikhub/instagram/v3/general_search" }, "parameters": [ { "name": "enable_metadata", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Enable metadata", "default": true, "title": "Enable Metadata" }, "description": "Enable metadata" }, { "name": "next_max_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination ID, omit for first request, get from previous response `data.next_max_id`", "title": "Next Max Id" }, "description": "Pagination ID, omit for first request, get from previous response `data.next_max_id`" }, { "name": "query", "in": "query", "required": true, "schema": { "type": "string", "description": "Search keyword", "title": "Query" }, "description": "Search keyword", "example": "justin" }, { "name": "rank_token", "in": "query", "required": false, "schema": { "type": "string", "description": "Rank token, omit for first request, get from previous response `data.rank_token`", "title": "Rank Token" }, "description": "Rank token, omit for first request, get from previous response `data.rank_token`" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e6c85226f2dba6e9309068706c47893aae829e4b8d53b0af609b79242c3cfdb6" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v3/general_search?query=justin' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v3-general_search" } }, "/apis/v1/tikhub/instagram/v3/get_comment_replies": { "get": { "description": "Instagram (v3).\n\n### Purpose\n- Get Instagram comment's child comments (replies) list\n- Support pagination to fetch all replies\n- Parent comment's comment_id can be obtained from get_post_comments API\n\n### Parameters\n- media_id: Post media ID (numeric ID, required), can be obtained via `/tikhub/instagram/v3/shortcode_to_media_id` endpoint\n- comment_id: Parent comment ID (required, get `pk` field from get_post_comments response)\n- min_id: Pagination cursor, omit for first request, get from previous response `data.next_min_child_cursor`\n\n### Return\n- `data.child_comments`: Child comments list\n - `user`: Commenter info\n - `text`: Comment text\n - `created_at`: Comment timestamp\n - `comment_like_count`: Comment likes count\n - `pk`: Comment ID\n- `data.next_min_child_cursor`: Next page cursor (use as min_id in next request)\n- `data.has_more_tail_child_comments`: Whether has more child comments\n- `data.num_tail_child_comments`: Remaining child comments count\n\n### Pagination usage\n1. First request: Pass `media_id` and `comment_id` parameters\n2. Get `data.next_min_child_cursor` from response\n3. Next request: Pass `next_min_child_cursor` as-is to `min_id` parameter (no pre-processing needed, the API handles unescaping automatically)\n4. Repeat steps 2-3 until `data.has_more_tail_child_comments` is false\n\n### Note\n- `min_id` may be an escaped JSON string (e.g. `{\"key\":\"val\"}`), just pass it as-is, the API handles unescaping internally\n\n### Example\nmedia_id = \"3829530490739515971\"\ncomment_id = \"18065937092249736\"\n\nAPI references: `get_post_comments` = `GET /tikhub/instagram/v3/get_post_comments` (operationId: `get_tikhub_instagram_v3_get_post_comments`); `shortcode_to_media_id` = `GET /tikhub/instagram/v3/shortcode_to_media_id` (operationId: `get_tikhub_instagram_v3_shortcode_to_media_id`).\n\n\nPublished reference price: $0.008 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v3_get_comment_replies", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `data.child_comments`: Child comments list\n - `user`: Commenter info\n - `text`: Comment text\n - `created_at`: Comment timestamp\n - `comment_like_count`: Comment likes count\n - `pk`: Comment ID\n- `data.next_min_child_cursor`: Next page cursor (use as min_id in next request)\n- `data.has_more_tail_child_comments`: Whether has more child comments\n- `data.num_tail_child_comments`: Remaining child comments count", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram get_comment_replies", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.008, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "c752acde3f0d" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v3/get_comment_replies", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v3_get_comment_replies", "method": "GET", "path": "/apis/v1/tikhub/instagram/v3/get_comment_replies" }, "parameters": [ { "name": "comment_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Parent comment ID (required, get `pk` field from get_post_comments response)\n\nAPI references: `get_post_comments` = `GET /tikhub/instagram/v3/get_post_comments` (operationId: `get_tikhub_instagram_v3_get_post_comments`).", "title": "Comment Id" }, "description": "Parent comment ID (required, get `pk` field from get_post_comments response)\n\nAPI references: `get_post_comments` = `GET /tikhub/instagram/v3/get_post_comments` (operationId: `get_tikhub_instagram_v3_get_post_comments`).", "example": "18065937092249736" }, { "name": "media_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Post media ID (numeric ID, required), can be obtained via `/tikhub/instagram/v3/shortcode_to_media_id` endpoint\n\nAPI references: `shortcode_to_media_id` = `GET /tikhub/instagram/v3/shortcode_to_media_id` (operationId: `get_tikhub_instagram_v3_shortcode_to_media_id`).", "title": "Media Id" }, "description": "Post media ID (numeric ID, required), can be obtained via `/tikhub/instagram/v3/shortcode_to_media_id` endpoint\n\nAPI references: `shortcode_to_media_id` = `GET /tikhub/instagram/v3/shortcode_to_media_id` (operationId: `get_tikhub_instagram_v3_shortcode_to_media_id`).", "example": "3829530490739515971" }, { "name": "min_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination cursor, omit for first request, get from previous response `data.next_min_child_cursor`", "title": "Min Id" }, "description": "Pagination cursor, omit for first request, get from previous response `data.next_min_child_cursor`" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e6950e1aefdeb300681303305caa116e816dab82d4e6ebd9f358a8bc8eeec765" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v3/get_comment_replies?comment_id=18065937092249736&media_id=3829530490739515971' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v3-get_comment_replies" } }, "/apis/v1/tikhub/instagram/v3/get_explore": { "get": { "description": "Instagram (v3).\n\n### Purpose\n- Get Instagram Explore/Discover page recommended posts\n- Returns personalized recommended post list\n- Support pagination to fetch more recommendations\n\n### Parameters\n- max_id: Pagination cursor, omit for first request, get from previous response `data.next_max_id`\n\n### Return\n- `data.sectional_items`: Recommended content section list\n - `layout_content.medias`: Media list\n - `media.id`: Post ID\n - `media.code`: Post shortcode\n - `media.media_type`: Media type (1=image, 2=video, 8=carousel)\n - `media.like_count`: Likes count\n - `media.comment_count`: Comments count\n - `media.caption.text`: Post caption text\n - `media.user`: Publisher info\n - `media.image_versions2`: Image version list\n - `media.video_versions`: Video version list (exists for videos)\n- `data.next_max_id`: Next page cursor (use as max_id in next request)\n- `data.more_available`: Whether has more content\n\n### Pagination usage\n1. First request: No parameters needed\n2. Get `data.next_max_id` from response\n3. Next request: Pass `max_id` (use next_max_id from previous)\n4. Repeat steps 2-3 until `data.more_available` is false\n\n### Example\n```\n# First page (no parameters)\n# Second page\n# max_id = \"...\" # Get from the first-page response\n```\n\n\nPublished reference price: $0.008 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v3_get_explore", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `data.sectional_items`: Recommended content section list\n - `layout_content.medias`: Media list\n - `media.id`: Post ID\n - `media.code`: Post shortcode\n - `media.media_type`: Media type (1=image, 2=video, 8=carousel)\n - `media.like_count`: Likes count\n - `media.comment_count`: Comments count\n - `media.caption.text`: Post caption text\n - `media.user`: Publisher info\n - `media.image_versions2`: Image version list\n - `media.video_versions`: Video version list (exists for videos)\n- `data.next_max_id`: Next page cursor (use as max_id in next request)\n- `data.more_available`: Whether has more content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram get_explore", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.008, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "9c73005a1c12" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v3/get_explore", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v3_get_explore", "method": "GET", "path": "/apis/v1/tikhub/instagram/v3/get_explore" }, "parameters": [ { "name": "max_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination cursor, omit for first request, get from previous response `data.next_max_id`", "title": "Max Id" }, "description": "Pagination cursor, omit for first request, get from previous response `data.next_max_id`" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:743851dc8d50ce21a3a4599839cb1879293fe6fcbc277cd4f1e42f47c393c6f3" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v3-get_explore" } }, "/apis/v1/tikhub/instagram/v3/get_hashtag_posts": { "get": { "description": "Instagram (v3).\n\n### Purpose\n- Get posts under a hashtag, with pagination\n\n### Parameters\n- tag: Hashtag keyword (without #)\n- max_id: Pagination cursor from previous response, omit for first request\n\n### Return\n- `data`: Hashtag posts list with pagination cursor\n\n### Example\ntag = \"cat\"\n\n\nPublished reference price: $0.008 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v3_get_hashtag_posts", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `data`: Hashtag posts list with pagination cursor", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram get_hashtag_posts", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.008, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "2b5bf1e76854" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v3/get_hashtag_posts", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v3_get_hashtag_posts", "method": "GET", "path": "/apis/v1/tikhub/instagram/v3/get_hashtag_posts" }, "parameters": [ { "name": "max_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination cursor from previous response, omit for first request", "title": "Max Id" }, "description": "Pagination cursor from previous response, omit for first request" }, { "name": "tag", "in": "query", "required": true, "schema": { "type": "string", "description": "Hashtag keyword (without #", "title": "Tag" }, "description": "Hashtag keyword (without #", "example": "cat" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:3bccda53b514a63e2b5ea15463829fdb392d4852ea6dc2ca6dc4d0866f176017" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v3/get_hashtag_posts?tag=cat' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v3-get_hashtag_posts" } }, "/apis/v1/tikhub/instagram/v3/get_highlight_stories": { "get": { "description": "Instagram (v3).\n\n### Purpose\n- Get Instagram Highlight's detailed story/post content\n- Returns all Stories media in the highlight collection\n\n### Parameters\n- highlight_id: Highlight ID, format `highlight:xxx` (get from get_user_highlights API)\n- reel_ids: Highlight ID list, comma separated (optional, if not provided only queries the highlight_id)\n - Example: `highlight:18064916456320419,highlight:18155682898389765`\n - Can query multiple highlights at once\n- first: Items per page (default 3)\n- last: Get last N items (default 2)\n\n### Return\n- `data.story_highlight_tray`: Highlight story collection\n - `id`: Highlight ID\n - `title`: Highlight title\n - `items`: Story list\n - `id`: Story ID\n - `pk`: Story PK\n - `taken_at`: Published timestamp\n - `media_type`: Media type (1=image, 2=video)\n - `image_versions2`: Image version list\n - `video_versions`: Video version list (exists for videos)\n - `user`: Publisher info\n\n### Example\n```\nhighlight_id = \"highlight:18064916456320419\"\n# reel_ids = \"highlight:18064916456320419,highlight:18155682898389765\"\n```\n\nAPI references: `get_user_highlights` = `GET /tikhub/instagram/v3/get_user_highlights` (operationId: `get_tikhub_instagram_v3_get_user_highlights`).\n\n\nPublished reference price: $0.008 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v3_get_highlight_stories", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `data.story_highlight_tray`: Highlight story collection\n - `id`: Highlight ID\n - `title`: Highlight title\n - `items`: Story list\n - `id`: Story ID\n - `pk`: Story PK\n - `taken_at`: Published timestamp\n - `media_type`: Media type (1=image, 2=video)\n - `image_versions2`: Image version list\n - `video_versions`: Video version list (exists for videos)\n - `user`: Publisher info", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram get_highlight_stories", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.008, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "c23d80be5b05" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v3/get_highlight_stories", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v3_get_highlight_stories", "method": "GET", "path": "/apis/v1/tikhub/instagram/v3/get_highlight_stories" }, "parameters": [ { "name": "first", "in": "query", "required": false, "schema": { "type": "integer", "description": "Items per page (default 3)", "default": 3, "title": "First" }, "description": "Items per page (default 3)" }, { "name": "highlight_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Highlight ID, format `highlight:xxx` (get from get_user_highlights API)\n\nAPI references: `get_user_highlights` = `GET /tikhub/instagram/v3/get_user_highlights` (operationId: `get_tikhub_instagram_v3_get_user_highlights`).", "title": "Highlight Id" }, "description": "Highlight ID, format `highlight:xxx` (get from get_user_highlights API)\n\nAPI references: `get_user_highlights` = `GET /tikhub/instagram/v3/get_user_highlights` (operationId: `get_tikhub_instagram_v3_get_user_highlights`).", "example": "highlight:18064916456320419" }, { "name": "last", "in": "query", "required": false, "schema": { "type": "integer", "description": "Get last N items (default 2)", "default": 2, "title": "Last" }, "description": "Get last N items (default 2)" }, { "name": "reel_ids", "in": "query", "required": false, "schema": { "type": "string", "description": "Highlight ID list, comma separated (optional, if not provided only queries the highlight_id)\n - Example: `highlight:18064916456320419,highlight:18155682898389765`\n - Can query multiple highlights at once", "title": "Reel Ids" }, "description": "Highlight ID list, comma separated (optional, if not provided only queries the highlight_id)\n - Example: `highlight:18064916456320419,highlight:18155682898389765`\n - Can query multiple highlights at once" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:c94a1bd9b6099f7e37fb3051faf8bb7b93f0e0014359a7930f1f009243aa62e2" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v3/get_highlight_stories?highlight_id=highlight%3A18064916456320419' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v3-get_highlight_stories" } }, "/apis/v1/tikhub/instagram/v3/get_location_info": { "get": { "description": "Instagram (v3).\n\n### Purpose\n- Get Instagram location/place detail info\n- Including name, address, coordinates, nearby places, etc.\n- Location ID can be obtained from search API (search_places) or post details\n\n### Parameters\n- location_id: Location ID (numeric)\n- show_nearby: Whether to show nearby places (default true)\n\n### Return\n- `data.native_location_data`: Location basic info\n - `name`: Location name\n - `address`: Address\n - `city`: City\n - `lat`: Latitude\n - `lng`: Longitude\n - `website`: Website\n - `phone`: Phone\n - `category`: Category\n - `media_count`: Associated posts count\n- `data.ranked`: Top posts info\n- `data.recent`: Recent posts info\n- `data.nearby_locations`: Nearby locations list (when show_nearby=true)\n\n### Example\nlocation_id = \"1016248898\"\n\n\nPublished reference price: $0.008 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v3_get_location_info", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `data.native_location_data`: Location basic info\n - `name`: Location name\n - `address`: Address\n - `city`: City\n - `lat`: Latitude\n - `lng`: Longitude\n - `website`: Website\n - `phone`: Phone\n - `category`: Category\n - `media_count`: Associated posts count\n- `data.ranked`: Top posts info\n- `data.recent`: Recent posts info\n- `data.nearby_locations`: Nearby locations list (when show_nearby=true)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram get_location_info", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.008, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "ec0d76b0f628" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v3/get_location_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v3_get_location_info", "method": "GET", "path": "/apis/v1/tikhub/instagram/v3/get_location_info" }, "parameters": [ { "name": "location_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Location ID", "title": "Location Id" }, "description": "Location ID", "example": "1016248898" }, { "name": "show_nearby", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether to show nearby places", "default": true, "title": "Show Nearby" }, "description": "Whether to show nearby places" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:88302e4a764bf544170b25281c8d1059253fd4b838f5b3c97a82d8ebc59eff33" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v3/get_location_info?location_id=1016248898' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v3-get_location_info" } }, "/apis/v1/tikhub/instagram/v3/get_location_nearby": { "get": { "description": "Instagram (v3).\n\n### Purpose\n- Get nearby local content aggregation for a location, including nearby places and popular posts\n- Useful for discovering related content in a geographic area\n\n### Parameters\n- location_id: Location ID, from post data `location.id`\n\n\nPublished reference price: $0.008 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v3_get_location_nearby", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram get_location_nearby", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.008, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "8303489653a7" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v3/get_location_nearby", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v3_get_location_nearby", "method": "GET", "path": "/apis/v1/tikhub/instagram/v3/get_location_nearby" }, "parameters": [ { "name": "location_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Location ID (numeric\n\nUsage: Location ID, from post data `location.id`", "title": "Location Id" }, "description": "Location ID (numeric\n\nUsage: Location ID, from post data `location.id`", "example": "213385402" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:27bbbea9f88f276297f7b8a4eda303b4ba36d4554a0c305527dbe53091614a42" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v3/get_location_nearby?location_id=213385402' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v3-get_location_nearby" } }, "/apis/v1/tikhub/instagram/v3/get_location_posts": { "get": { "description": "Instagram (v3).\n\n### Purpose\n- Get Instagram location-related posts\n- Support sorting by top or latest\n- Location ID can be obtained from search API (search_places) or post details\n\n### Parameters\n- location_id: Location ID (numeric)\n- tab: Post sort order\n - `ranked`: Top posts (default)\n - `recent`: Latest posts\n- first: Posts per page (default 12, max 50)\n- after: Pagination cursor from previous response `page_info.end_cursor`\n- page_size_override: Posts per page (default 12)\n\n### Return\n- `data.sections`: Post section list\n - `layout_content.medias`: Media list\n - `media.id`: Post ID\n - `media.code`: Post shortcode\n - `media.media_type`: Media type (1=image, 2=video, 8=carousel)\n - `media.like_count`: Likes count\n - `media.comment_count`: Comments count\n - `media.caption.text`: Post caption text\n - `media.user`: Publisher info\n- `data.next_max_id`: Next page cursor\n- `data.next_page`: Next page info\n- `data.more_available`: Whether has more content\n\n### Example\nlocation_id = \"1016248898\"\ntab = \"ranked\"\n\n\nPublished reference price: $0.008 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v3_get_location_posts", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `data.sections`: Post section list\n - `layout_content.medias`: Media list\n - `media.id`: Post ID\n - `media.code`: Post shortcode\n - `media.media_type`: Media type (1=image, 2=video, 8=carousel)\n - `media.like_count`: Likes count\n - `media.comment_count`: Comments count\n - `media.caption.text`: Post caption text\n - `media.user`: Publisher info\n- `data.next_max_id`: Next page cursor\n- `data.next_page`: Next page info\n- `data.more_available`: Whether has more content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram get_location_posts", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.008, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "48edba2596d4" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v3/get_location_posts", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v3_get_location_posts", "method": "GET", "path": "/apis/v1/tikhub/instagram/v3/get_location_posts" }, "parameters": [ { "name": "after", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination cursor from previous response `page_info.end_cursor`", "title": "After" }, "description": "Pagination cursor from previous response `page_info.end_cursor`" }, { "name": "first", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 50, "minimum": 1, "description": "Posts per page (default 12, max 50)", "default": 12, "title": "First" }, "description": "Posts per page (default 12, max 50)" }, { "name": "location_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Location ID", "title": "Location Id" }, "description": "Location ID", "example": "1016248898" }, { "name": "page_size_override", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page size\n\nUsage: Posts per page (default 12)", "default": 12, "title": "Page Size Override" }, "description": "Page size\n\nUsage: Posts per page (default 12)" }, { "name": "tab", "in": "query", "required": false, "schema": { "enum": [ "ranked", "recent" ], "type": "string", "description": "latest). Example: ranked\n\nUsage: Post sort order\n - `ranked`: Top posts (default)\n - `recent`: Latest posts", "default": "ranked", "title": "Tab" }, "description": "latest). Example: ranked\n\nUsage: Post sort order\n - `ranked`: Top posts (default)\n - `recent`: Latest posts" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:c8df82609c50e6d77e0ff4e7970c01e172b3bfcca99be7741a506752416e27af" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v3/get_location_posts?location_id=1016248898' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v3-get_location_posts" } }, "/apis/v1/tikhub/instagram/v3/get_music_posts": { "get": { "description": "Instagram (v3).\n\n### Purpose\n- Get Reels using a specific audio (background music), with pagination\n\n### Parameters\n- audio_cluster_id: Audio ID, obtainable from Reels audio field\n- max_id: Pagination cursor from previous response, omit for first request\n\n### Return\n- `data`: Reels list using the audio with pagination cursor\n\n### Example\naudio_cluster_id = \"18066165960103621\"\n\n\nPublished reference price: $0.008 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v3_get_music_posts", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `data`: Reels list using the audio with pagination cursor", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram get_music_posts", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.008, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "af2066c84842" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v3/get_music_posts", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v3_get_music_posts", "method": "GET", "path": "/apis/v1/tikhub/instagram/v3/get_music_posts" }, "parameters": [ { "name": "audio_cluster_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Audio ID, obtainable from Reels audio field", "title": "Audio Cluster Id" }, "description": "Audio ID, obtainable from Reels audio field", "example": "18066165960103621" }, { "name": "max_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination cursor from previous response, omit for first request", "title": "Max Id" }, "description": "Pagination cursor from previous response, omit for first request" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e004f8ce132b9ec4008ad68135d87efe26d8bf43c819ac4d291d1980ff03a416" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v3/get_music_posts?audio_cluster_id=18066165960103621' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v3-get_music_posts" } }, "/apis/v1/tikhub/instagram/v3/get_post_comments": { "get": { "description": "Instagram (v3).\n\n### Purpose\n- Get Instagram post comment list\n- Support pagination to fetch all comments\n- Support sorting by popular or newest\n\n### Parameters\n- code: Post shortcode (e.g., DUajw4YkorV, required)\n- min_id: Pagination cursor, omit for first request, get from previous response `data.next_min_id`\n- sort_order: Sort order\n - `popular`: Sort by popular (default)\n - `newest`: Sort by newest\n\n### Return\n- `data.comments`: Comment list\n - `user`: Commenter info\n - `text`: Comment text\n - `created_at`: Comment timestamp\n - `comment_like_count`: Comment likes count\n - `child_comment_count`: Child comments count\n- `data.next_min_id`: Next page cursor (use as min_id in next request)\n- `data.has_more_comments`: Whether has more comments\n- `data.comment_count`: Total comment count\n\n### Pagination usage\n1. First request: Pass `code` parameter\n2. Get `data.next_min_id` from response\n3. Next request: Pass `next_min_id` as-is to `min_id` parameter (no pre-processing needed, the API handles unescaping automatically)\n4. Repeat steps 2-3 until `data.has_more_comments` is false\n\n### Note\n- `min_id` is an escaped JSON string returned by the API (e.g., `\"{\"cached_comments_cursor\":\"xxx\",\"bifilter_token\":\"xxx\"}\"`), just pass it as-is, the API handles unescaping internally\n\n### Example\ncode = \"DUajw4YkorV\"\n\n\nPublished reference price: $0.008 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v3_get_post_comments", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `data.comments`: Comment list\n - `user`: Commenter info\n - `text`: Comment text\n - `created_at`: Comment timestamp\n - `comment_like_count`: Comment likes count\n - `child_comment_count`: Child comments count\n- `data.next_min_id`: Next page cursor (use as min_id in next request)\n- `data.has_more_comments`: Whether has more comments\n- `data.comment_count`: Total comment count", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram get_post_comments", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.008, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "0265225a0d30" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v3/get_post_comments", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v3_get_post_comments", "method": "GET", "path": "/apis/v1/tikhub/instagram/v3/get_post_comments" }, "parameters": [ { "name": "code", "in": "query", "required": true, "schema": { "type": "string", "description": "Post shortcode (e.g., DUajw4YkorV", "title": "Code" }, "description": "Post shortcode (e.g., DUajw4YkorV", "example": "DUajw4YkorV" }, { "name": "min_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination cursor, omit for first request, get from previous response `data.next_min_id`", "title": "Min Id" }, "description": "Pagination cursor, omit for first request, get from previous response `data.next_min_id`" }, { "name": "sort_order", "in": "query", "required": false, "schema": { "enum": [ "popular", "newest" ], "type": "string", "description": "Sort order. /Options: popular( ), newest( ). Example: popular\n\nUsage: Sort order\n - `popular`: Sort by popular (default)\n - `newest`: Sort by newest", "default": "popular", "title": "Sort Order" }, "description": "Sort order. /Options: popular( ), newest( ). Example: popular\n\nUsage: Sort order\n - `popular`: Sort by popular (default)\n - `newest`: Sort by newest" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:5782c844d569debb38ba92a091b3affa86cc4d08139cf23bf317a5f252d169ec" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v3/get_post_comments?code=DUajw4YkorV' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v3-get_post_comments" } }, "/apis/v1/tikhub/instagram/v3/get_post_info": { "get": { "description": "Instagram (v3).\n\n### Purpose\n- Get post details by media ID or post URL\n- Returns complete post info including images/videos, likes, comments, author info, etc.\n\n### Parameters\n- media_id: Post media ID (numeric ID), can be obtained via `/tikhub/instagram/v3/shortcode_to_media_id` endpoint\n- url: Post URL, e.g. `https://www.instagram.com/p/DUajw4YkorV/`, supports `/p`, `/reel`, `/reels`, `/tv` paths\n- **At least one of media_id or url is required; media_id wins if both provided**\n\n### Return\n- `data.items`: Post info list (usually only one element)\n - `id`: Post ID\n - `code`: Post shortcode\n - `media_type`: Media type (1=image, 2=video, 8=carousel)\n - `like_count`: Likes count\n - `comment_count`: Comments count\n - `caption.text`: Post caption text\n - `user`: Publisher info\n - `image_versions2`: Image version list\n - `video_versions`: Video version list (exists for videos)\n - `carousel_media`: Carousel media list (exists for carousels)\n - `taken_at`: Published timestamp\n\n### Example\n```\n# by media_id\nmedia_id = \"3850699893338385742\"\n\n# by url\nurl = \"https://www.instagram.com/p/DUajw4YkorV/\"\n```\n\nAPI references: `shortcode_to_media_id` = `GET /tikhub/instagram/v3/shortcode_to_media_id` (operationId: `get_tikhub_instagram_v3_shortcode_to_media_id`).\n\n\nPublished reference price: $0.008 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v3_get_post_info", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `data.items`: Post info list (usually only one element)\n - `id`: Post ID\n - `code`: Post shortcode\n - `media_type`: Media type (1=image, 2=video, 8=carousel)\n - `like_count`: Likes count\n - `comment_count`: Comments count\n - `caption.text`: Post caption text\n - `user`: Publisher info\n - `image_versions2`: Image version list\n - `video_versions`: Video version list (exists for videos)\n - `carousel_media`: Carousel media list (exists for carousels)\n - `taken_at`: Published timestamp", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram get_post_info", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.008, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "0211205ce1bc" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v3/get_post_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v3_get_post_info", "method": "GET", "path": "/apis/v1/tikhub/instagram/v3/get_post_info" }, "parameters": [ { "name": "media_id", "in": "query", "required": false, "schema": { "description": "ID/Post media ID url\n\nUsage: Post media ID (numeric ID), can be obtained via `/tikhub/instagram/v3/shortcode_to_media_id` endpoint\n\nAPI references: `shortcode_to_media_id` = `GET /tikhub/instagram/v3/shortcode_to_media_id` (operationId: `get_tikhub_instagram_v3_shortcode_to_media_id`).", "title": "Media Id", "type": [ "string", "null" ] }, "description": "ID/Post media ID url\n\nUsage: Post media ID (numeric ID), can be obtained via `/tikhub/instagram/v3/shortcode_to_media_id` endpoint\n\nAPI references: `shortcode_to_media_id` = `GET /tikhub/instagram/v3/shortcode_to_media_id` (operationId: `get_tikhub_instagram_v3_shortcode_to_media_id`).", "example": "3850699893338385742" }, { "name": "url", "in": "query", "required": false, "schema": { "description": "URL/Post URL media_id /p /reel /reels /tv\n\nUsage: Post URL, e.g. `https://www.instagram.com/p/DUajw4YkorV/`, supports `/p`, `/reel`, `/reels`, `/tv` paths", "title": "Url", "type": [ "string", "null" ] }, "description": "URL/Post URL media_id /p /reel /reels /tv\n\nUsage: Post URL, e.g. `https://www.instagram.com/p/DUajw4YkorV/`, supports `/p`, `/reel`, `/reels`, `/tv` paths", "example": "https://www.instagram.com/p/DUajw4YkorV/" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:a6c7af6ee6cffc0fd7285b704adcba1a5674c8ea32c63cf23483b5c451b361d9" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v3-get_post_info" } }, "/apis/v1/tikhub/instagram/v3/get_post_info_by_code": { "get": { "description": "Instagram (v3).\n\n### Purpose\n- Get post details by shortcode\n- Shortcode is the identifier in the post URL, e.g., `DUajw4YkorV` from `https://www.instagram.com/p/DUajw4YkorV/`\n- Returns complete post info\n\n### Parameters\n- code: Post shortcode (e.g., DUajw4YkorV, required)\n\n### Return\n- `data.items`: Post info list\n - `id`: Post ID\n - `code`: Post shortcode\n - `media_type`: Media type (1=image, 2=video, 8=carousel)\n - `like_count`: Likes count\n - `comment_count`: Comments count\n - `caption.text`: Post caption text\n - `user`: Publisher info\n - `image_versions2`: Image version list\n - `video_versions`: Video version list (exists for videos)\n - `carousel_media`: Carousel media list (exists for carousels)\n - `taken_at`: Published timestamp\n\n### Example\ncode = \"DUajw4YkorV\"\n\n\nPublished reference price: $0.008 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v3_get_post_info_by_code", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `data.items`: Post info list\n - `id`: Post ID\n - `code`: Post shortcode\n - `media_type`: Media type (1=image, 2=video, 8=carousel)\n - `like_count`: Likes count\n - `comment_count`: Comments count\n - `caption.text`: Post caption text\n - `user`: Publisher info\n - `image_versions2`: Image version list\n - `video_versions`: Video version list (exists for videos)\n - `carousel_media`: Carousel media list (exists for carousels)\n - `taken_at`: Published timestamp", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram get_post_info_by_code", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.008, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "53dbdd6b25f9" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v3/get_post_info_by_code", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v3_get_post_info_by_code", "method": "GET", "path": "/apis/v1/tikhub/instagram/v3/get_post_info_by_code" }, "parameters": [ { "name": "code", "in": "query", "required": true, "schema": { "type": "string", "description": "Post shortcode (e.g., DUajw4YkorV, required)", "title": "Code" }, "description": "Post shortcode (e.g., DUajw4YkorV, required)", "example": "DUajw4YkorV" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:cd928f0822b7bf512ef335d70d2b46fd8fa2e09762ba38999021c9d67fb1f164" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v3/get_post_info_by_code?code=DUajw4YkorV' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v3-get_post_info_by_code" } }, "/apis/v1/tikhub/instagram/v3/get_post_likes": { "get": { "description": "Instagram (v3).\n\n### Purpose\n- Get list of users who liked an Instagram post\n\n### Parameters\n- code: Post shortcode (from post URL, e.g. instagram.com/p/{code}/)\n\n### Return\n- `data.users`: List of users who liked\n\n### Note\n- Web likes list is returned in one shot, no pagination\n\n### Example\ncode = \"DavSf9yS6wy\"\n\n\nPublished reference price: $0.008 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v3_get_post_likes", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `data.users`: List of users who liked", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram get_post_likes", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.008, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "dc7647f2b589" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v3/get_post_likes", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v3_get_post_likes", "method": "GET", "path": "/apis/v1/tikhub/instagram/v3/get_post_likes" }, "parameters": [ { "name": "code", "in": "query", "required": true, "schema": { "type": "string", "description": "Post shortcode (from post URL, e.g. instagram.com/p/{code}/)", "title": "Code" }, "description": "Post shortcode (from post URL, e.g. instagram.com/p/{code}/)", "example": "DavSf9yS6wy" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:21aa266f68a7744ac4ed5f19534cbfbdcd8f3d18d820c0aae11a9e8d9bf7f6ce" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v3/get_post_likes?code=DavSf9yS6wy' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v3-get_post_likes" } }, "/apis/v1/tikhub/instagram/v3/get_post_oembed": { "get": { "description": "Instagram (v3).\n\n### Purpose\n- Get Instagram post oEmbed embed info\n- Returns HTML code for embedding and post metadata\n- Suitable for embedding Instagram posts on third-party websites\n\n### Parameters\n- url: Full Instagram post URL (e.g., `https://www.instagram.com/p/xxx/` or `https://www.instagram.com/reel/xxx/`)\n- hidecaption: Whether to hide caption (default false)\n- maxwidth: Max embed width in pixels (default 540)\n\n### Return\n- `data.version`: oEmbed version\n- `data.title`: Post title\n- `data.author_name`: Author name\n- `data.author_url`: Author profile URL\n- `data.author_id`: Author ID\n- `data.media_id`: Media ID\n- `data.provider_name`: Provider name (Instagram)\n- `data.provider_url`: Provider URL\n- `data.type`: Type (rich)\n- `data.width`: Width\n- `data.html`: HTML embed code\n- `data.thumbnail_url`: Thumbnail URL\n- `data.thumbnail_width`: Thumbnail width\n- `data.thumbnail_height`: Thumbnail height\n\n### Example\nurl = \"https://www.instagram.com/reel/DUlObENDmJD\"\n\n\nPublished reference price: $0.008 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v3_get_post_oembed", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `data.version`: oEmbed version\n- `data.title`: Post title\n- `data.author_name`: Author name\n- `data.author_url`: Author profile URL\n- `data.author_id`: Author ID\n- `data.media_id`: Media ID\n- `data.provider_name`: Provider name (Instagram)\n- `data.provider_url`: Provider URL\n- `data.type`: Type (rich)\n- `data.width`: Width\n- `data.html`: HTML embed code\n- `data.thumbnail_url`: Thumbnail URL\n- `data.thumbnail_width`: Thumbnail width\n- `data.thumbnail_height`: Thumbnail height", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram get_post_oembed", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.008, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "202bb3463efb" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v3/get_post_oembed", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v3_get_post_oembed", "method": "GET", "path": "/apis/v1/tikhub/instagram/v3/get_post_oembed" }, "parameters": [ { "name": "hidecaption", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether to hide caption", "default": false, "title": "Hidecaption" }, "description": "Whether to hide caption" }, { "name": "maxwidth", "in": "query", "required": false, "schema": { "type": "integer", "description": "Max embed width in pixels (default 540)", "default": 540, "title": "Maxwidth" }, "description": "Max embed width in pixels (default 540)" }, { "name": "url", "in": "query", "required": true, "schema": { "type": "string", "description": "Full Instagram post URL (e.g., `https://www.instagram.com/p/xxx/` or `https://www.instagram.com/reel/xxx/`)", "title": "Url" }, "description": "Full Instagram post URL (e.g., `https://www.instagram.com/p/xxx/` or `https://www.instagram.com/reel/xxx/`)", "example": "https://www.instagram.com/reel/DUlObENDmJD" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:859f926c1493376526805037350a6e52994d6a1eb79aec219ca6c7433345a7bb" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v3/get_post_oembed?url=https%3A%2F%2Fwww.instagram.com%2Freel%2FDUlObENDmJD' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v3-get_post_oembed" } }, "/apis/v1/tikhub/instagram/v3/get_recommended_reels": { "get": { "description": "Instagram (v3).\n\n### Purpose\n- Get Instagram Reels recommendation feed\n- Support pagination to fetch more Reels\n\n### Parameters\n- first: Number of Reels to fetch per request (default 12, max 50)\n- after: Pagination cursor, omit for first request, get from previous response `data.page_info.end_cursor`\n\n### Return\n- `data.edges`: Reels list\n - `node.media`: Reels media info\n - `code`: Post shortcode\n - `pk`: Post ID\n - `like_count`: Likes count\n - `comment_count`: Comments count\n - `play_count`: Play count\n - `caption.text`: Description text\n - `user`: Publisher info\n - `video_versions`: Video version list\n - `image_versions2`: Cover image version list\n- `data.page_info`: Pagination info\n - `has_next_page`: Whether has next page\n - `end_cursor`: Next page cursor (use as after parameter in next request)\n\n### Pagination usage\n1. First request: Only pass `first` parameter\n2. Get `data.page_info.end_cursor` from response\n3. Next request: Pass `first` and `after` (use end_cursor from previous)\n4. Repeat steps 2-3 until `data.page_info.has_next_page` is false\n\n### Example\nfirst = 12\n\n\nPublished reference price: $0.008 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v3_get_recommended_reels", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `data.edges`: Reels list\n - `node.media`: Reels media info\n - `code`: Post shortcode\n - `pk`: Post ID\n - `like_count`: Likes count\n - `comment_count`: Comments count\n - `play_count`: Play count\n - `caption.text`: Description text\n - `user`: Publisher info\n - `video_versions`: Video version list\n - `image_versions2`: Cover image version list\n- `data.page_info`: Pagination info\n - `has_next_page`: Whether has next page\n - `end_cursor`: Next page cursor (use as after parameter in next request)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram get_recommended_reels", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.008, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "d88a470855cf" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v3/get_recommended_reels", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v3_get_recommended_reels", "method": "GET", "path": "/apis/v1/tikhub/instagram/v3/get_recommended_reels" }, "parameters": [ { "name": "after", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination cursor, omit for first request, get from previous response `data.page_info.end_cursor`", "title": "After" }, "description": "Pagination cursor, omit for first request, get from previous response `data.page_info.end_cursor`" }, { "name": "first", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 50, "minimum": 1, "description": "Number of Reels to fetch per request (default 12, max 50)", "default": 12, "title": "First" }, "description": "Number of Reels to fetch per request (default 12, max 50)" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:8de1d7fd0d3804cdafc3e3ce6c362564eceac419e7e872ba240b7bdd2b4a5889" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v3-get_recommended_reels" } }, "/apis/v1/tikhub/instagram/v3/get_similar_users": { "get": { "description": "Instagram (v3).\n\n### Purpose\n- Get recommended accounts similar to the given user\n\n### Parameters\n- user_id: Target user ID (numeric), obtainable via get_user_id_by_username\n\n### Return\n- `data.users`: List of similar accounts\n\n### Example\nuser_id = \"25025320\"\n\nAPI references: `get_user_id_by_username` = `GET /tikhub/instagram/v3/get_user_id_by_username` (operationId: `get_tikhub_instagram_v3_get_user_id_by_username`).\n\n\nPublished reference price: $0.008 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v3_get_similar_users", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `data.users`: List of similar accounts", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram get_similar_users", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.008, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "7c523c0436a9" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v3/get_similar_users", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v3_get_similar_users", "method": "GET", "path": "/apis/v1/tikhub/instagram/v3/get_similar_users" }, "parameters": [ { "name": "user_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Target user ID (numeric), obtainable via get_user_id_by_username\n\nAPI references: `get_user_id_by_username` = `GET /tikhub/instagram/v3/get_user_id_by_username` (operationId: `get_tikhub_instagram_v3_get_user_id_by_username`).", "title": "User Id" }, "description": "Target user ID (numeric), obtainable via get_user_id_by_username\n\nAPI references: `get_user_id_by_username` = `GET /tikhub/instagram/v3/get_user_id_by_username` (operationId: `get_tikhub_instagram_v3_get_user_id_by_username`).", "example": "25025320" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:c00e0a02e9bc9947267514a69f9d6f72458c04416659451dd5de886bc20c65c6" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v3/get_similar_users?user_id=25025320' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v3-get_similar_users" } }, "/apis/v1/tikhub/instagram/v3/get_user_about": { "get": { "description": "Instagram (v3).\n\n### Purpose\n- Get Instagram user's About This Account information\n- Including account creation date, location, etc.\n\n### Parameters\n- username: Instagram username (required)\n\n### Return\n- Account creation date\n- Account location/country\n- Use `get_user_former_usernames` to query the username change count; individual former usernames and change dates are not provided\n- Other account related info\n\n### Example\nusername = \"instagram\"\n\nAPI references: `get_user_former_usernames` = `GET /tikhub/instagram/v3/get_user_former_usernames` (operationId: `get_tikhub_instagram_v3_get_user_former_usernames`).\n\n\nPublished reference price: $0.008 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v3_get_user_about", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Account creation date\n- Account location/country\n- Use `get_user_former_usernames` to query the username change count; individual former usernames and change dates are not provided\n- Other account related info\n\nAPI references: `get_user_former_usernames` = `GET /tikhub/instagram/v3/get_user_former_usernames` (operationId: `get_tikhub_instagram_v3_get_user_former_usernames`).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram get_user_about", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.008, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "1a227d2b4fbb" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v3/get_user_about", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v3_get_user_about", "method": "GET", "path": "/apis/v1/tikhub/instagram/v3/get_user_about" }, "parameters": [ { "name": "username", "in": "query", "required": true, "schema": { "type": "string", "description": "Username", "title": "Username" }, "description": "Username", "example": "instagram" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:9302d7afcf3301d2a6ac80767febb5bb8d3fd352d92be533c26b41dd5e3ade23" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v3/get_user_about?username=instagram' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v3-get_user_about" } }, "/apis/v1/tikhub/instagram/v3/get_user_brief": { "get": { "description": "Instagram (v3).\n\n### Purpose\n- Get Instagram user brief/hover card info\n- Returns core user info, faster response than get_user_profile\n- Suitable for batch fetching user summary info\n\n### Parameters\n- user_id: Instagram user ID (numeric, required)\n- username: Instagram username (required)\n\n### Return\n- `data.id`: User ID\n- `data.username`: Username\n- `data.full_name`: Full name\n- `data.biography`: Biography\n- `data.profile_pic_url`: Profile picture URL\n- `data.is_verified`: Whether verified\n- `data.is_private`: Whether private account\n- `data.edge_followed_by.count`: Followers count\n- `data.edge_follow.count`: Following count\n- `data.edge_owner_to_timeline_media`: Recent posts preview\n\n### Example\nuser_id = \"791258468\"\nusername = \"99brasil\"\n\nAPI references: `get_user_profile` = `GET /tikhub/instagram/v3/get_user_profile` (operationId: `get_tikhub_instagram_v3_get_user_profile`).\n\n\nPublished reference price: $0.008 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v3_get_user_brief", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `data.id`: User ID\n- `data.username`: Username\n- `data.full_name`: Full name\n- `data.biography`: Biography\n- `data.profile_pic_url`: Profile picture URL\n- `data.is_verified`: Whether verified\n- `data.is_private`: Whether private account\n- `data.edge_followed_by.count`: Followers count\n- `data.edge_follow.count`: Following count\n- `data.edge_owner_to_timeline_media`: Recent posts preview", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram get_user_brief", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.008, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "0ce10701b1cb" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v3/get_user_brief", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v3_get_user_brief", "method": "GET", "path": "/apis/v1/tikhub/instagram/v3/get_user_brief" }, "parameters": [ { "name": "user_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Instagram user ID (numeric, required)", "title": "User Id" }, "description": "Instagram user ID (numeric, required)", "example": "791258468" }, { "name": "username", "in": "query", "required": true, "schema": { "type": "string", "description": "Username", "title": "Username" }, "description": "Username", "example": "99brasil" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:87b2c14d6a5e3e0e43aa2a80fc54cf6a3b32a68fc1329738cb250a3297a8a2a4" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v3/get_user_brief?user_id=791258468&username=99brasil' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v3-get_user_brief" } }, "/apis/v1/tikhub/instagram/v3/get_user_followers": { "get": { "description": "Instagram (v3).\n\n### Purpose\n- Get Instagram user's followers list\n- Returns all accounts that follow this user\n- Support pagination\n\n### Parameters\n- username: Instagram username (required)\n- count: Number of users to fetch per request (default 12, max 100)\n- max_id: Pagination cursor, omit for first request, get from previous response `data.next_max_id`\n\n### Return\n- `data.users`: Followers user list\n - `pk`: User ID\n - `username`: Username\n - `full_name`: Full name\n - `is_private`: Whether private account\n - `is_verified`: Whether verified\n - `profile_pic_url`: Profile picture URL\n- `data.next_max_id`: Next page cursor (use as max_id in next request)\n- `data.big_list`: Whether has more data\n- `data.page_size`: Page size\n- `data.status`: Status\n\n### Pagination usage\n1. First request: Only pass `username` and `count` parameters\n2. Get `data.next_max_id` from response\n3. Next request: Pass `username`, `count`, and `max_id` (use next_max_id from previous)\n4. Repeat steps 2-3 until response has no `next_max_id` field\n\n### Example\nusername = \"instagram\"\ncount = 12\n\n\nPublished reference price: $0.008 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v3_get_user_followers", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `data.users`: Followers user list\n - `pk`: User ID\n - `username`: Username\n - `full_name`: Full name\n - `is_private`: Whether private account\n - `is_verified`: Whether verified\n - `profile_pic_url`: Profile picture URL\n- `data.next_max_id`: Next page cursor (use as max_id in next request)\n- `data.big_list`: Whether has more data\n- `data.page_size`: Page size\n- `data.status`: Status", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram get_user_followers", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.008, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "991dbfa6f313" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v3/get_user_followers", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v3_get_user_followers", "method": "GET", "path": "/apis/v1/tikhub/instagram/v3/get_user_followers" }, "parameters": [ { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 1, "description": "Number of users to fetch per request (default 12, max 100)", "default": 12, "title": "Count" }, "description": "Number of users to fetch per request (default 12, max 100)" }, { "name": "max_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination cursor, omit for first request, get from previous response `data.next_max_id`", "title": "Max Id" }, "description": "Pagination cursor, omit for first request, get from previous response `data.next_max_id`" }, { "name": "username", "in": "query", "required": true, "schema": { "type": "string", "description": "Username", "title": "Username" }, "description": "Username", "example": "instagram" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:3364787c31846404229f3e5fcfc638c86de2b5706c6e679dba9a0a0c3a6a5f44" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v3/get_user_followers?username=instagram' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v3-get_user_followers" } }, "/apis/v1/tikhub/instagram/v3/get_user_following": { "get": { "description": "Instagram (v3).\n\n### Purpose\n- Get Instagram user's following list\n- Returns all accounts the user follows\n- Support pagination\n\n### Parameters\n- username: Instagram username (required)\n- count: Number of users to fetch per request (default 12, max 100)\n- max_id: Pagination cursor, omit for first request, get from previous response `data.next_max_id`\n\n### Return\n- `data.users`: Following user list\n - `pk`: User ID\n - `username`: Username\n - `full_name`: Full name\n - `is_private`: Whether private account\n - `is_verified`: Whether verified\n - `profile_pic_url`: Profile picture URL\n- `data.next_max_id`: Next page cursor (use as max_id in next request)\n- `data.big_list`: Whether has more data\n- `data.page_size`: Page size\n- `data.status`: Status\n\n### Pagination usage\n1. First request: Only pass `username` and `count` parameters\n2. Get `data.next_max_id` from response\n3. Next request: Pass `username`, `count`, and `max_id` (use next_max_id from previous)\n4. Repeat steps 2-3 until response has no `next_max_id` field\n\n### Example\nusername = \"instagram\"\ncount = 12\n\n\nPublished reference price: $0.008 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v3_get_user_following", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `data.users`: Following user list\n - `pk`: User ID\n - `username`: Username\n - `full_name`: Full name\n - `is_private`: Whether private account\n - `is_verified`: Whether verified\n - `profile_pic_url`: Profile picture URL\n- `data.next_max_id`: Next page cursor (use as max_id in next request)\n- `data.big_list`: Whether has more data\n- `data.page_size`: Page size\n- `data.status`: Status", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram get_user_following", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.008, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "9e463a1fbada" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v3/get_user_following", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v3_get_user_following", "method": "GET", "path": "/apis/v1/tikhub/instagram/v3/get_user_following" }, "parameters": [ { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 1, "description": "Number of users to fetch per request (default 12, max 100)", "default": 12, "title": "Count" }, "description": "Number of users to fetch per request (default 12, max 100)" }, { "name": "max_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination cursor, omit for first request, get from previous response `data.next_max_id`", "title": "Max Id" }, "description": "Pagination cursor, omit for first request, get from previous response `data.next_max_id`" }, { "name": "username", "in": "query", "required": true, "schema": { "type": "string", "description": "Username", "title": "Username" }, "description": "Username", "example": "instagram" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:7a7311d7d934359b27acf095a48694e789bdf24cdad6f64e8926b5bfce078ef4" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v3/get_user_following?username=instagram' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v3-get_user_following" } }, "/apis/v1/tikhub/instagram/v3/get_user_former_usernames": { "get": { "description": "Instagram (v3).\n\n### Purpose\n- Get the number of times an Instagram user has changed their username\n\n### Parameters\n- username: Instagram username (required)\n\n### Return\n- username: Instagram username\n- former_username_count: Number of username changes (a non-negative integer)\n- has_former_usernames: Whether the username has changed; true when the count is greater than 0 and false when it is 0\n\n### Note\n- Only the change count is provided, not individual former usernames or change dates\n- A successfully retrieved count of 0 is still a billable result, not an empty list\n- An error is returned when the count cannot be retrieved; an unknown count is not treated as 0\n\n### Request example\nusername = \"presjek.me\"\n\n\nPublished reference price: $0.008 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v3_get_user_former_usernames", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- username: Instagram username\n- former_username_count: Number of username changes (a non-negative integer)\n- has_former_usernames: Whether the username has changed; true when the count is greater than 0 and false when it is 0", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram get_user_former_usernames", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.008, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "568f5d248a38" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v3/get_user_former_usernames", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v3_get_user_former_usernames", "method": "GET", "path": "/apis/v1/tikhub/instagram/v3/get_user_former_usernames" }, "parameters": [ { "name": "username", "in": "query", "required": true, "schema": { "type": "string", "description": "Username", "title": "Username" }, "description": "Username", "example": "instagram" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:5161422d0dd80b7fe2d382e18dc52428d4a6cb3cb7f8a1ace8c320a4a3b1b64f" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v3/get_user_former_usernames?username=instagram' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v3-get_user_former_usernames" } }, "/apis/v1/tikhub/instagram/v3/get_user_highlights": { "get": { "description": "Instagram (v3).\n\n### Purpose\n- Get Instagram user's Highlights list\n- Returns all highlight collections created by the user\n- Support pagination\n\n### Parameters\n- username: Instagram username (required)\n- first: Number of highlights per page (default 10, max 50)\n- after: Forward pagination cursor, from previous response `data.page_info.end_cursor`\n- before: Backward pagination cursor, from previous response `data.page_info.start_cursor`\n- last: Highlights per page for backward pagination, use with `before`\n\n### Return\n- `data.edges`: Highlights list\n - `node.id`: Highlight ID (format: highlight:xxx)\n - `node.title`: Highlight title\n - `node.cover_media`: Cover media info\n - `node.cover_media_cropped_thumbnail`: Cropped cover thumbnail\n - `node.media_count`: Number of stories in highlight\n- `data.page_info`: Pagination info\n - `has_next_page`: Whether has next page\n - `end_cursor`: Next page cursor (use as after parameter in next request)\n\n### Pagination usage\n1. First request: Only pass `username` and `first` parameters\n2. Get `data.page_info.end_cursor` from response\n3. Next request: Pass `username`, `first`, and `after` (use end_cursor from previous)\n4. Repeat steps 2-3 until `data.page_info.has_next_page` is false\n\n### Example\nusername = \"instagram\"\nfirst = 10\n\n\nPublished reference price: $0.008 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v3_get_user_highlights", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `data.edges`: Highlights list\n - `node.id`: Highlight ID (format: highlight:xxx)\n - `node.title`: Highlight title\n - `node.cover_media`: Cover media info\n - `node.cover_media_cropped_thumbnail`: Cropped cover thumbnail\n - `node.media_count`: Number of stories in highlight\n- `data.page_info`: Pagination info\n - `has_next_page`: Whether has next page\n - `end_cursor`: Next page cursor (use as after parameter in next request)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram get_user_highlights", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.008, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "1d9f57bd8d2e" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v3/get_user_highlights", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v3_get_user_highlights", "method": "GET", "path": "/apis/v1/tikhub/instagram/v3/get_user_highlights" }, "parameters": [ { "name": "after", "in": "query", "required": false, "schema": { "type": "string", "description": "Forward pagination cursor, from previous response `data.page_info.end_cursor`", "title": "After" }, "description": "Forward pagination cursor, from previous response `data.page_info.end_cursor`" }, { "name": "before", "in": "query", "required": false, "schema": { "type": "string", "description": "Backward pagination cursor, from previous response `data.page_info.start_cursor`", "title": "Before" }, "description": "Backward pagination cursor, from previous response `data.page_info.start_cursor`" }, { "name": "first", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 50, "minimum": 1, "description": "Number of highlights per page (default 10, max 50)", "default": 10, "title": "First" }, "description": "Number of highlights per page (default 10, max 50)" }, { "name": "last", "in": "query", "required": false, "schema": { "type": "integer", "description": "Highlights per page for backward pagination, use with `before`", "title": "Last" }, "description": "Highlights per page for backward pagination, use with `before`" }, { "name": "username", "in": "query", "required": true, "schema": { "type": "string", "description": "Username", "title": "Username" }, "description": "Username", "example": "instagram" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:fc2586f37ecdb87079c19a9a1e889a1d7691c52bdf0b0ad4ec8c3d293d6483e5" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v3/get_user_highlights?username=instagram' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v3-get_user_highlights" } }, "/apis/v1/tikhub/instagram/v3/get_user_id_by_username": { "get": { "description": "Instagram (v3).\n\n### Purpose\n- Get Instagram user ID by username\n- User ID is the unique identifier used internally by Instagram, usually a numeric string\n\n### Parameters\n- username: Instagram username\n\n### Return\n- `data.user_id`: User ID\n\n### Example\nusername = \"liensue.talks\"\n\n\nPublished reference price: $0.008 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v3_get_user_id_by_username", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `data.user_id`: User ID", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram get_user_id_by_username", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.008, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "69d9757b66c2" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v3/get_user_id_by_username", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v3_get_user_id_by_username", "method": "GET", "path": "/apis/v1/tikhub/instagram/v3/get_user_id_by_username" }, "parameters": [ { "name": "username", "in": "query", "required": true, "schema": { "type": "string", "description": "Username", "title": "Username" }, "description": "Username", "example": "liensue.talks" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:56b33890ca7afa0b7d3bc89e39af5a7946bbf7bd7d052ae4c9032d7c836f3987" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v3/get_user_id_by_username?username=liensue.talks' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v3-get_user_id_by_username" } }, "/apis/v1/tikhub/instagram/v3/get_user_posts": { "get": { "description": "Instagram (v3).\n\n### Purpose\n- Get user's post list with forward/backward pagination\n\n### Parameters\n- **username**: Username string (e.g. `99brasil`), **NOT numeric user_id**\n- **first**: Posts per page for forward pagination (default 12, max 50)\n- **after**: Forward pagination cursor, from previous response `page_info.end_cursor`\n- **before**: Backward pagination cursor, from previous response `page_info.start_cursor`\n- **last**: Posts per page for backward pagination, use with `before`\n- **count**: Number of posts for first request (default 12)\n\n### Pagination\n- **Forward**: Use `first` + `after`\n- **Backward**: Use `last` + `before`\n\n### Example\n```\n# First page\nGET /tikhub/instagram/v3/get_user_posts?username=99brasil&first=12\n\n# Second page (forward)\nGET /tikhub/instagram/v3/get_user_posts?username=99brasil&first=12&after=QVFCcmN1YlF...\n```\n\n\nPublished reference price: $0.008 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v3_get_user_posts", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram get_user_posts", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.008, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "98f219fba4f9" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v3/get_user_posts", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v3_get_user_posts", "method": "GET", "path": "/apis/v1/tikhub/instagram/v3/get_user_posts" }, "parameters": [ { "name": "after", "in": "query", "required": false, "schema": { "type": "string", "description": "Forward pagination cursor, from previous response `page_info.end_cursor`", "title": "After" }, "description": "Forward pagination cursor, from previous response `page_info.end_cursor`" }, { "name": "before", "in": "query", "required": false, "schema": { "type": "string", "description": "Backward pagination cursor, from previous response `page_info.start_cursor`", "title": "Before" }, "description": "Backward pagination cursor, from previous response `page_info.start_cursor`" }, { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number of posts for first request (default 12)", "default": 12, "title": "Count" }, "description": "Number of posts for first request (default 12)" }, { "name": "first", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 50, "minimum": 1, "description": "Posts per page for forward pagination (default 12, max 50)", "default": 12, "title": "First" }, "description": "Posts per page for forward pagination (default 12, max 50)" }, { "name": "last", "in": "query", "required": false, "schema": { "type": "integer", "description": "Posts per page for backward pagination, use with `before`", "title": "Last" }, "description": "Posts per page for backward pagination, use with `before`" }, { "name": "username", "in": "query", "required": true, "schema": { "type": "string", "description": "Instagram username (without @\n\nUsage: Username string (e.g. `99brasil`), **NOT numeric user_id**", "title": "Username" }, "description": "Instagram username (without @\n\nUsage: Username string (e.g. `99brasil`), **NOT numeric user_id**", "example": "99brasil" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:27bbbea9f88f276297f7b8a4eda303b4ba36d4554a0c305527dbe53091614a42" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v3/get_user_posts?username=99brasil' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v3-get_user_posts" } }, "/apis/v1/tikhub/instagram/v3/get_user_profile": { "get": { "description": "Instagram (v3).\n\n### Purpose\n- Get complete Instagram user profile information\n- Including basic info, statistics, recent posts, etc.\n\n### Parameters\n- username: Instagram username (required)\n\n### Return\n- `data.user.id`: User ID\n- `data.user.username`: Username\n- `data.user.full_name`: Full name\n- `data.user.biography`: Biography\n- `data.user.external_url`: External URL\n- `data.user.profile_pic_url`: Profile picture URL (standard)\n- `data.user.profile_pic_url_hd`: Profile picture URL (HD)\n- `data.user.is_verified`: Whether verified\n- `data.user.is_private`: Whether private account\n- `data.user.edge_followed_by.count`: Followers count\n- `data.user.edge_follow.count`: Following count\n- `data.user.edge_owner_to_timeline_media.count`: Total posts count\n- `data.user.edge_felix_video_timeline.count`: Reels/videos count\n\n### Example\nusername = \"instagram\"\n\n\nPublished reference price: $0.008 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v3_get_user_profile", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `data.user.id`: User ID\n- `data.user.username`: Username\n- `data.user.full_name`: Full name\n- `data.user.biography`: Biography\n- `data.user.external_url`: External URL\n- `data.user.profile_pic_url`: Profile picture URL (standard)\n- `data.user.profile_pic_url_hd`: Profile picture URL (HD)\n- `data.user.is_verified`: Whether verified\n- `data.user.is_private`: Whether private account\n- `data.user.edge_followed_by.count`: Followers count\n- `data.user.edge_follow.count`: Following count\n- `data.user.edge_owner_to_timeline_media.count`: Total posts count\n- `data.user.edge_felix_video_timeline.count`: Reels/videos count", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram get_user_profile", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.008, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "e6bd2ab7a227" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v3/get_user_profile", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v3_get_user_profile", "method": "GET", "path": "/apis/v1/tikhub/instagram/v3/get_user_profile" }, "parameters": [ { "name": "username", "in": "query", "required": true, "schema": { "type": "string", "description": "Username", "title": "Username" }, "description": "Username", "example": "instagram" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e6e7ce7631c2f0a8a70a6edcb46184c9c5dc71497d87254fc9f8632f0079a784" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v3/get_user_profile?username=instagram' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v3-get_user_profile" } }, "/apis/v1/tikhub/instagram/v3/get_user_reels": { "get": { "description": "Instagram (v3).\n\n### Purpose\n- Get Instagram user's Reels list\n- Support pagination to fetch all user's Reels\n\n### Parameters\n- username: Instagram username (required)\n- first: Reels per page for forward pagination (default 12, max 50)\n- after: Forward pagination cursor, from previous response `data.page_info.end_cursor`\n- before: Backward pagination cursor, from previous response `data.page_info.start_cursor`\n- last: Reels per page for backward pagination, use with `before`\n- page_size: Videos per page (default 12)\n\n### Return\n- `data.edges`: Reels list\n - `node.media`: Reels media info\n - `code`: Post shortcode\n - `pk`: Post ID\n - `like_count`: Likes count\n - `comment_count`: Comments count\n - `play_count`: Play count\n - `caption.text`: Description text\n - `user`: Publisher info\n - `video_versions`: Video version list\n - `image_versions2`: Cover image version list\n- `data.page_info`: Pagination info\n - `has_next_page`: Whether has next page\n - `end_cursor`: Next page cursor (use as after parameter in next request)\n\n### Pagination usage\n1. First request: Only pass `username` and `first` parameters\n2. Get `data.page_info.end_cursor` from response\n3. Next request: Pass `username`, `first`, and `after` (use end_cursor from previous)\n4. Repeat steps 2-3 until `data.page_info.has_next_page` is false\n\n### Example\nusername = \"instagram\"\nfirst = 12\n\n\nPublished reference price: $0.008 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v3_get_user_reels", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `data.edges`: Reels list\n - `node.media`: Reels media info\n - `code`: Post shortcode\n - `pk`: Post ID\n - `like_count`: Likes count\n - `comment_count`: Comments count\n - `play_count`: Play count\n - `caption.text`: Description text\n - `user`: Publisher info\n - `video_versions`: Video version list\n - `image_versions2`: Cover image version list\n- `data.page_info`: Pagination info\n - `has_next_page`: Whether has next page\n - `end_cursor`: Next page cursor (use as after parameter in next request)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram get_user_reels", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.008, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "1e7d0348f0b0" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v3/get_user_reels", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v3_get_user_reels", "method": "GET", "path": "/apis/v1/tikhub/instagram/v3/get_user_reels" }, "parameters": [ { "name": "after", "in": "query", "required": false, "schema": { "type": "string", "description": "Forward pagination cursor, from previous response `data.page_info.end_cursor`", "title": "After" }, "description": "Forward pagination cursor, from previous response `data.page_info.end_cursor`" }, { "name": "before", "in": "query", "required": false, "schema": { "type": "string", "description": "Backward pagination cursor, from previous response `data.page_info.start_cursor`", "title": "Before" }, "description": "Backward pagination cursor, from previous response `data.page_info.start_cursor`" }, { "name": "first", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 50, "minimum": 1, "description": "Reels per page for forward pagination (default 12, max 50)", "default": 12, "title": "First" }, "description": "Reels per page for forward pagination (default 12, max 50)" }, { "name": "last", "in": "query", "required": false, "schema": { "type": "integer", "description": "Reels per page for backward pagination, use with `before`", "title": "Last" }, "description": "Reels per page for backward pagination, use with `before`" }, { "name": "page_size", "in": "query", "required": false, "schema": { "type": "integer", "description": "Videos per page (default 12)", "default": 12, "title": "Page Size" }, "description": "Videos per page (default 12)" }, { "name": "username", "in": "query", "required": true, "schema": { "type": "string", "description": "Username", "title": "Username" }, "description": "Username", "example": "instagram" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:8de1d7fd0d3804cdafc3e3ce6c362564eceac419e7e872ba240b7bdd2b4a5889" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v3/get_user_reels?username=instagram' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v3-get_user_reels" } }, "/apis/v1/tikhub/instagram/v3/get_user_stories": { "get": { "description": "Instagram (v3).\n\n### Purpose\n- Get Instagram user's Stories list\n- Stories displayed when clicking on user's profile picture (published within 24 hours)\n\n### Parameters\n- username: Instagram username (required)\n\n### Return\n- `data.reels_media`: Stories list (grouped by user)\n - `id`: User ID\n - `user`: User info\n - `username`: Username\n - `full_name`: Full name\n - `profile_pic_url`: Profile picture URL\n - `items`: Stories item list\n - `id`: Story ID\n - `pk`: Story PK\n - `taken_at`: Published timestamp\n - `media_type`: Media type (1=image, 2=video)\n - `image_versions2`: Image version list\n - `video_versions`: Video version list (exists for videos)\n - `story_cta`: Story link (if any)\n- `data.reels`: Stories detailed info\n\n### Note\n- Stories have a 24-hour expiration, cannot be fetched after expiration\n- Private account's Stories require following to view\n\n### Example\n```\nusername = \"instagram\"\n```\n\n\nPublished reference price: $0.008 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v3_get_user_stories", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `data.reels_media`: Stories list (grouped by user)\n - `id`: User ID\n - `user`: User info\n - `username`: Username\n - `full_name`: Full name\n - `profile_pic_url`: Profile picture URL\n - `items`: Stories item list\n - `id`: Story ID\n - `pk`: Story PK\n - `taken_at`: Published timestamp\n - `media_type`: Media type (1=image, 2=video)\n - `image_versions2`: Image version list\n - `video_versions`: Video version list (exists for videos)\n - `story_cta`: Story link (if any)\n- `data.reels`: Stories detailed info", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram get_user_stories", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.008, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "80e456ae1214" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v3/get_user_stories", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v3_get_user_stories", "method": "GET", "path": "/apis/v1/tikhub/instagram/v3/get_user_stories" }, "parameters": [ { "name": "username", "in": "query", "required": true, "schema": { "type": "string", "description": "Username", "title": "Username" }, "description": "Username", "example": "instagram" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e548c4ae0de96c312a6486c3884b955abb9a7e9a6e0af0dd1c10aa8fbc5cb625" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v3/get_user_stories?username=instagram' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v3-get_user_stories" } }, "/apis/v1/tikhub/instagram/v3/get_user_tagged_posts": { "get": { "description": "Instagram (v3).\n\n### Purpose\n- Get Instagram user's tagged posts list\n- Posts where other users tagged this user\n- Support pagination\n\n### Parameters\n- username: Instagram username (required)\n- first: Posts per page for forward pagination (default 12, max 50)\n- after: Forward pagination cursor, from previous response `data.page_info.end_cursor`\n- before: Backward pagination cursor, from previous response `data.page_info.start_cursor`\n- last: Posts per page for backward pagination, use with `before`\n- count: Number of posts for first request (default 12)\n\n### Return\n- `data.edges`: Post list\n - `node.id`: Post ID\n - `node.code`: Post shortcode\n - `node.display_url`: Display image URL\n - `node.taken_at`: Published timestamp\n - `node.like_count`: Likes count\n - `node.comment_count`: Comments count\n - `node.caption.text`: Post caption text\n - `node.user`: Post author info\n- `data.page_info`: Pagination info\n - `has_next_page`: Whether has next page\n - `end_cursor`: Next page cursor (use as after parameter in next request)\n\n### Pagination usage\n1. First request: Only pass `username` and `first` parameters\n2. Get `data.page_info.end_cursor` from response\n3. Next request: Pass `username`, `first`, and `after` (use end_cursor from previous)\n4. Repeat steps 2-3 until `data.page_info.has_next_page` is false\n\n### Example\nusername = \"instagram\"\nfirst = 12\n\n\nPublished reference price: $0.008 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v3_get_user_tagged_posts", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `data.edges`: Post list\n - `node.id`: Post ID\n - `node.code`: Post shortcode\n - `node.display_url`: Display image URL\n - `node.taken_at`: Published timestamp\n - `node.like_count`: Likes count\n - `node.comment_count`: Comments count\n - `node.caption.text`: Post caption text\n - `node.user`: Post author info\n- `data.page_info`: Pagination info\n - `has_next_page`: Whether has next page\n - `end_cursor`: Next page cursor (use as after parameter in next request)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram get_user_tagged_posts", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.008, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "73493df498bd" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v3/get_user_tagged_posts", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v3_get_user_tagged_posts", "method": "GET", "path": "/apis/v1/tikhub/instagram/v3/get_user_tagged_posts" }, "parameters": [ { "name": "after", "in": "query", "required": false, "schema": { "type": "string", "description": "Forward pagination cursor, from previous response `data.page_info.end_cursor`", "title": "After" }, "description": "Forward pagination cursor, from previous response `data.page_info.end_cursor`" }, { "name": "before", "in": "query", "required": false, "schema": { "type": "string", "description": "Backward pagination cursor, from previous response `data.page_info.start_cursor`", "title": "Before" }, "description": "Backward pagination cursor, from previous response `data.page_info.start_cursor`" }, { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number of posts for first request (default 12)", "default": 12, "title": "Count" }, "description": "Number of posts for first request (default 12)" }, { "name": "first", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 50, "minimum": 1, "description": "Posts per page for forward pagination (default 12, max 50)", "default": 12, "title": "First" }, "description": "Posts per page for forward pagination (default 12, max 50)" }, { "name": "last", "in": "query", "required": false, "schema": { "type": "integer", "description": "Posts per page for backward pagination, use with `before`", "title": "Last" }, "description": "Posts per page for backward pagination, use with `before`" }, { "name": "username", "in": "query", "required": true, "schema": { "type": "string", "description": "Username", "title": "Username" }, "description": "Username", "example": "instagram" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:7433e5acbb1832e65c0bf7c78708e20aa86081e4180baa68d20653fe26cce1f4" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v3/get_user_tagged_posts?username=instagram' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v3-get_user_tagged_posts" } }, "/apis/v1/tikhub/instagram/v3/media_id_to_shortcode": { "get": { "description": "Instagram (v3).\n\n### Purpose\n- Convert numeric media_id to post shortcode\n- Shortcode can be used to construct post URL: instagram.com/p/{shortcode}/\n\n### Parameters\n- media_id: Post media ID (numeric ID)\n\n### Return\n- `data.media_id`: Original media ID\n- `data.shortcode`: Converted shortcode\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v3_media_id_to_shortcode", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `data.media_id`: Original media ID\n- `data.shortcode`: Converted shortcode", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram media_id_to_shortcode", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "26b3a9f2e8cf" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v3/media_id_to_shortcode", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v3_media_id_to_shortcode", "method": "GET", "path": "/apis/v1/tikhub/instagram/v3/media_id_to_shortcode" }, "parameters": [ { "name": "media_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Post media ID", "title": "Media Id" }, "description": "Post media ID", "example": "3850699893338385742" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e4c1ce41b0c8206ce8a245bfe07034bfe13bfd034d3981ff0736c67996fdf5bb" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v3/media_id_to_shortcode?media_id=3850699893338385742' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v3-media_id_to_shortcode" } }, "/apis/v1/tikhub/instagram/v3/search_by_coordinates": { "get": { "description": "Instagram (v3).\n\n### Purpose\n- Search nearby Instagram locations by GPS coordinates\n\n### Parameters\n- latitude: Latitude\n- longitude: Longitude\n\n### Return\n- `data`: List of nearby locations\n\n### Example\nlatitude = 40.7\nlongitude = -74\n\n\nPublished reference price: $0.008 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v3_search_by_coordinates", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `data`: List of nearby locations", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram search_by_coordinates", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.008, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "b22b476ba994" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v3/search_by_coordinates", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v3_search_by_coordinates", "method": "GET", "path": "/apis/v1/tikhub/instagram/v3/search_by_coordinates" }, "parameters": [ { "name": "latitude", "in": "query", "required": true, "schema": { "type": "number", "description": "Latitude", "title": "Latitude" }, "description": "Latitude", "example": 40.7 }, { "name": "longitude", "in": "query", "required": true, "schema": { "type": "number", "description": "Longitude", "title": "Longitude" }, "description": "Longitude", "example": -74 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:78f382e9e55ab415d63190d868b8dcbf86bd7140894e445a7f4c35998b6fa51d" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v3/search_by_coordinates?latitude=40.7&longitude=-74' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v3-search_by_coordinates" } }, "/apis/v1/tikhub/instagram/v3/search_hashtags": { "get": { "description": "Instagram (v3).\n\n### Purpose\n- Instagram hashtag search API\n- Returns only hashtag search results\n\n### Parameters\n- query: Search keyword\n- rank_token: Rank token from previous search response for pagination\n\n### Return\n- `data.hashtags`: Hashtag search results\n- `data.rank_token`: Rank token\n- `data.see_more`: See more info\n- `data.inform_module`: Inform module\n\n### Example\nquery = \"fashion\"\n\n\nPublished reference price: $0.008 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v3_search_hashtags", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `data.hashtags`: Hashtag search results\n- `data.rank_token`: Rank token\n- `data.see_more`: See more info\n- `data.inform_module`: Inform module", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram search_hashtags", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.008, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "b4110d12479b" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v3/search_hashtags", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v3_search_hashtags", "method": "GET", "path": "/apis/v1/tikhub/instagram/v3/search_hashtags" }, "parameters": [ { "name": "query", "in": "query", "required": true, "schema": { "type": "string", "description": "Search keyword", "title": "Query" }, "description": "Search keyword", "example": "fashion" }, { "name": "rank_token", "in": "query", "required": false, "schema": { "type": "string", "description": "Rank token from previous search response for pagination", "title": "Rank Token" }, "description": "Rank token from previous search response for pagination" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:a333fa5e72c8fb3d995093c2e8d96341b243a0be5b07d16693f87c5129df6fb0" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v3/search_hashtags?query=fashion' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v3-search_hashtags" } }, "/apis/v1/tikhub/instagram/v3/search_users": { "get": { "description": "Instagram (v3).\n\n### Purpose\n- Instagram user search API\n- Returns only user search results\n\n### Parameters\n- query: Search keyword\n- rank_token: Rank token from previous search response for pagination\n\n### Return\n- `data.users`: User search results\n- `data.rank_token`: Rank token\n- `data.see_more`: See more info\n- `data.inform_module`: Inform module\n\n### Example\nquery = \"justin\"\n\n\nPublished reference price: $0.008 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v3_search_users", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `data.users`: User search results\n- `data.rank_token`: Rank token\n- `data.see_more`: See more info\n- `data.inform_module`: Inform module", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram search_users", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.008, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "af3a0a6ec0ae" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v3/search_users", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v3_search_users", "method": "GET", "path": "/apis/v1/tikhub/instagram/v3/search_users" }, "parameters": [ { "name": "query", "in": "query", "required": true, "schema": { "type": "string", "description": "Search keyword", "title": "Query" }, "description": "Search keyword", "example": "justin" }, { "name": "rank_token", "in": "query", "required": false, "schema": { "type": "string", "description": "Rank token from previous search response for pagination", "title": "Rank Token" }, "description": "Rank token from previous search response for pagination" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:2bda5e9d8683c984622657caa42664d4a09aa2cd19bfa26ef5936838a058088e" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v3/search_users?query=justin' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v3-search_users" } }, "/apis/v1/tikhub/instagram/v3/shortcode_to_media_id": { "get": { "description": "Instagram (v3).\n\n### Purpose:\n- Convert post shortcode to numeric media_id\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v3_shortcode_to_media_id", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram shortcode_to_media_id", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a43b228ab21c" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v3/shortcode_to_media_id", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v3_shortcode_to_media_id", "method": "GET", "path": "/apis/v1/tikhub/instagram/v3/shortcode_to_media_id" }, "parameters": [ { "name": "shortcode", "in": "query", "required": true, "schema": { "type": "string", "description": "Post shortcode", "title": "Shortcode" }, "description": "Post shortcode", "example": "CrgVBtHrFHm" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:27bbbea9f88f276297f7b8a4eda303b4ba36d4554a0c305527dbe53091614a42" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v3/shortcode_to_media_id?shortcode=CrgVBtHrFHm' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v3-shortcode_to_media_id" } }, "/apis/v1/tikhub/instagram/v3/translate_comment": { "get": { "description": "Instagram (v3).\n\n### Purpose\n- Translate Instagram post caption\n- Internally forces is_caption=True, specifically for translating post captions\n\n### Parameters\n- comment_id: Post media ID\n\n### Return\n- `data.translation`: Translated text\n- `data.source_language`: Source language\n\n### Note\n- The target translation language depends on the language setting of the account associated with the cookie used (usually English)\n- Cannot specify the target language, it is automatically determined by Instagram based on the account settings\n\n### Example\ncomment_id = \"18191961100350646\"\n\n\nPublished reference price: $0.008 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v3_translate_comment", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `data.translation`: Translated text\n- `data.source_language`: Source language", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram translate_comment", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.008, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "d76bbff66836" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v3/translate_comment", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v3_translate_comment", "method": "GET", "path": "/apis/v1/tikhub/instagram/v3/translate_comment" }, "parameters": [ { "name": "comment_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Comment ID or caption media ID", "title": "Comment Id" }, "description": "Comment ID or caption media ID", "example": "18191961100350646" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:233b531790476cec655a1c5c9dc669b40c34bcc4afab5f1e1924b1d2bf518c00" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v3/translate_comment?comment_id=18191961100350646' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v3-translate_comment" } }, "/apis/v1/tikhub/instagram/v3/user_id_to_username": { "get": { "description": "Instagram (v3).\n\n### Purpose\n- Get Instagram user info by user ID\n- Inverse operation of get_user_id_by_username (ID → user info)\n\n### Parameters\n- user_id: Instagram user ID (numeric string)\n\n### Return\n- `data.username`: Username\n- `data.full_name`: Full name\n- `data.pk` / `data.id`: User ID\n- `data.biography`: Biography\n- `data.profile_pic_url`: Profile picture URL\n- `data.follower_count`: Followers count\n- `data.is_private`: Whether private account\n- `data.is_verified`: Whether verified\n\n### Example\nuser_id = \"25025320\"\n\nAPI references: `get_user_id_by_username` = `GET /tikhub/instagram/v3/get_user_id_by_username` (operationId: `get_tikhub_instagram_v3_get_user_id_by_username`).\n\n\nPublished reference price: $0.008 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_instagram_v3_user_id_to_username", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `data.username`: Username\n- `data.full_name`: Full name\n- `data.pk` / `data.id`: User ID\n- `data.biography`: Biography\n- `data.profile_pic_url`: Profile picture URL\n- `data.follower_count`: Followers count\n- `data.is_private`: Whether private account\n- `data.is_verified`: Whether verified", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "instagram user_id_to_username", "tags": [ "tikhub.instagram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v3", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.008, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "9fb9f8ffadd8" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/instagram/v3/user_id_to_username", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_instagram_v3_user_id_to_username", "method": "GET", "path": "/apis/v1/tikhub/instagram/v3/user_id_to_username" }, "parameters": [ { "name": "user_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Instagram user ID (numeric string)", "title": "User Id" }, "description": "Instagram user ID (numeric string)", "example": "25025320" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:77daf1c71a5a0ca49248e8f3aeccabc51b59313a28fceec479579def77543ca5" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/instagram/v3/user_id_to_username?user_id=25025320' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-instagram-v3-user_id_to_username" } }, "/apis/v1/tikhub/kuaishou/app/fetch_brand_top_list": { "get": { "description": "Kuaishou (app).\n\n### Purpose\nGet brand rankings by category.\n\n### Parameters\nUse the ID/name pair below. Chinese names are wire values and must be passed verbatim.\n\n| Category | subTabId | subTabName |\n|---|---|---|\n| Default list | 0 | Omit this optional parameter |\n| Apparel | 131 | `\"服饰\"` |\n| Automotive | 1 | `\"汽车\"` |\n| Gaming | 25 | `\"游戏\"` |\n| Healthcare | 24 | `\"医疗健康\"` |\n| Consumer electronics | 130 | `\"3C数码\"` |\n| Phones | 128 | `\"手机\"` |\n| Home appliances | 11 | `\"家电\"` |\n| Parenting | 4 | `\"母婴\"` |\n| Food and beverages | 2 | `\"食品饮料\"` |\n\n### Return\nRanking data.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_kuaishou_app_fetch_brand_top_list", "responses": { "200": { "description": "Successful Response\n\n### Return\nRanking data.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "kuaishou fetch_brand_top_list", "tags": [ "tikhub.kuaishou" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "07c704fc726a" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/kuaishou/app/fetch_brand_top_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_kuaishou_app_fetch_brand_top_list", "method": "GET", "path": "/apis/v1/tikhub/kuaishou/app/fetch_brand_top_list" }, "parameters": [ { "name": "subTabId", "in": "query", "required": false, "schema": { "type": "integer", "title": "Sub tag ID", "default": 0 }, "description": "Sub-list identifier. Use an ID/name pair from the endpoint table; 0 selects the default list." }, { "name": "subTabName", "in": "query", "required": false, "schema": { "type": "string", "title": "Sub tag name", "default": "" }, "description": "Sub-list name. Use the exact Chinese name paired with subTabId in the endpoint table. Omit this optional parameter for the default list." } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:fb602007f5b6c688e163da53a5ffcbc12d514a20f27e4c146d045d5cb63021db" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-kuaishou-app-fetch_brand_top_list" } }, "/apis/v1/tikhub/kuaishou/app/fetch_hot_board_categories": { "get": { "description": "Kuaishou (app).\n\n### Purpose:\n- Kuaishou hot categories\n### Returns:\n- Categories data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_kuaishou_app_fetch_hot_board_categories", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Categories data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "kuaishou fetch_hot_board_categories", "tags": [ "tikhub.kuaishou" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "919ff79a6309" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/kuaishou/app/fetch_hot_board_categories", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_kuaishou_app_fetch_hot_board_categories", "method": "GET", "path": "/apis/v1/tikhub/kuaishou/app/fetch_hot_board_categories" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:2f35d002e0dbfb256b5d9f39c6d79d92b0f1dbebe55a840e989c09315b7b2623" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-kuaishou-app-fetch_hot_board_categories" } }, "/apis/v1/tikhub/kuaishou/app/fetch_hot_board_detail": { "get": { "description": "Kuaishou (app).\n\n### Purpose:\n- Kuaishou hot board detail\n### Parameters:\n- boardType: Board type\n- boardId: Board ID\n- boardType and boardId can be obtained from the hot board categories interface.\n### Returns:\n- Detail data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_kuaishou_app_fetch_hot_board_detail", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Detail data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "kuaishou fetch_hot_board_detail", "tags": [ "tikhub.kuaishou" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "0b6dc0a44e59" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/kuaishou/app/fetch_hot_board_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_kuaishou_app_fetch_hot_board_detail", "method": "GET", "path": "/apis/v1/tikhub/kuaishou/app/fetch_hot_board_detail" }, "parameters": [ { "name": "boardId", "in": "query", "required": false, "schema": { "type": "integer", "title": "Board ID", "default": 1 }, "description": "Board ID" }, { "name": "boardType", "in": "query", "required": false, "schema": { "type": "integer", "title": "Board type", "default": 1 }, "description": "Board type" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:af4253d362ab6cf4c0ecfc271e079b0a965dc090877ebab613e6fbfac5d3a32a" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-kuaishou-app-fetch_hot_board_detail" } }, "/apis/v1/tikhub/kuaishou/app/fetch_hot_search_person": { "get": { "description": "Kuaishou (app).\n\n### Purpose:\n- Kuaishou hot search person board\n### Returns:\n- Board data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_kuaishou_app_fetch_hot_search_person", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Board data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "kuaishou fetch_hot_search_person", "tags": [ "tikhub.kuaishou" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "c015286a5fc2" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/kuaishou/app/fetch_hot_search_person", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_kuaishou_app_fetch_hot_search_person", "method": "GET", "path": "/apis/v1/tikhub/kuaishou/app/fetch_hot_search_person" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:f52cd55d7845077dbc9f2b20d52a483abc46771a09df089711d29624c5d90352" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-kuaishou-app-fetch_hot_search_person" } }, "/apis/v1/tikhub/kuaishou/app/fetch_live_top_list": { "get": { "description": "Kuaishou (app).\n\n### Purpose\nGet live-stream rankings by category.\n\n### Parameters\nUse the ID/name pair below. Chinese names are wire values and must be passed verbatim.\n\n| Category | subTabId | subTabName |\n|---|---|---|\n| Default list | 0 | Omit this optional parameter |\n| Music | 102 | `\"音乐\"` |\n| Dance | 107 | `\"舞蹈\"` |\n| Beauty | 101 | `\"颜值\"` |\n| Traditional arts | 105 | `\"国艺\"` |\n| Dating | 111 | `\"相亲\"` |\n| Gaming | 106 | `\"游戏\"` |\n| Animation | 110 | `\"二次元\"` |\n| Stories | 104 | `\"故事\"` |\n| Group broadcasts | 113 | `\"团播\"` |\n| Grid broadcasts | 114 | `\"九宫格\"` |\n\n### Return\nRanking data.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_kuaishou_app_fetch_live_top_list", "responses": { "200": { "description": "Successful Response\n\n### Return\nRanking data.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "kuaishou fetch_live_top_list", "tags": [ "tikhub.kuaishou" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "71716290f315" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/kuaishou/app/fetch_live_top_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_kuaishou_app_fetch_live_top_list", "method": "GET", "path": "/apis/v1/tikhub/kuaishou/app/fetch_live_top_list" }, "parameters": [ { "name": "subTabId", "in": "query", "required": false, "schema": { "type": "integer", "title": "Sub tag ID", "default": 0 }, "description": "Sub-list identifier. Use an ID/name pair from the endpoint table; 0 selects the default list." }, { "name": "subTabName", "in": "query", "required": false, "schema": { "type": "string", "title": "Sub tag name", "default": "" }, "description": "Sub-list name. Use the exact Chinese name paired with subTabId in the endpoint table. Omit this optional parameter for the default list." } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:fb602007f5b6c688e163da53a5ffcbc12d514a20f27e4c146d045d5cb63021db" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-kuaishou-app-fetch_live_top_list" } }, "/apis/v1/tikhub/kuaishou/app/fetch_music_ranking": { "get": { "description": "Kuaishou (app).\n\n### Purpose:\n- Fetch music ranking (songs in musics[]), with cursor pagination.\n### Parameters:\n- tab_id: 100002=hot songs (default), 100063=Pi-plan ranking\n- count: Page size, default 20, range 1-50\n- pcursor: Cursor, empty for first page\n### Returns:\n- Music ranking data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_kuaishou_app_fetch_music_ranking", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Music ranking data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "kuaishou fetch_music_ranking", "tags": [ "tikhub.kuaishou" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "17b9b21990e3" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/kuaishou/app/fetch_music_ranking", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_kuaishou_app_fetch_music_ranking", "method": "GET", "path": "/apis/v1/tikhub/kuaishou/app/fetch_music_ranking" }, "parameters": [ { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "title": "Page size", "description": "Default 20, range 1-50", "default": 20, "minimum": 1, "maximum": 50 }, "description": "Default 20, range 1-50" }, { "name": "pcursor", "in": "query", "required": false, "schema": { "type": "string", "title": "Pagination cursor", "description": "Leave empty for the first page, pass pcursor from the previous response for subsequent pages", "default": "" }, "description": "Leave empty for the first page, pass pcursor from the previous response for subsequent pages" }, { "name": "tab_id", "in": "query", "required": false, "schema": { "type": "integer", "title": "Tab ID", "description": "100002=Hot Songs Chart (default), 100063=Pi Plan Recommended Chart", "default": 100002 }, "description": "100002=Hot Songs Chart (default), 100063=Pi Plan Recommended Chart" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:86c91730d3c3cf84926cc39909c0f081e71ee07f66fe4196ce142880ecad2c60" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-kuaishou-app-fetch_music_ranking" } }, "/apis/v1/tikhub/kuaishou/app/fetch_one_user_v2": { "get": { "description": "Kuaishou (app).\n\n### Purpose:\n- Fetch single user data V2\n- This API is more expensive, but more stable, please check the price list in the user background for specific prices.\n### Parameters:\n- user_id: Supports `eid` or `userId`, `eid` is part of the user profile link, and `user_id` can be obtained from different interfaces.\n- Both user IDs can be used, here are examples of the two user IDs, both of which point to the same user:\n - eid = \"3xz63mn6fngqtiq\"\n - userId = \"228905802\"\n### Returns:\n- User data\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_kuaishou_app_fetch_one_user_v2", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- User data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "kuaishou fetch_one_user", "tags": [ "tikhub.kuaishou" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a67bc9b5c86f" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/kuaishou/app/fetch_one_user_v2", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_kuaishou_app_fetch_one_user_v2", "method": "GET", "path": "/apis/v1/tikhub/kuaishou/app/fetch_one_user_v2" }, "parameters": [ { "name": "user_id", "in": "query", "required": true, "schema": { "type": "string", "title": "User ID" }, "example": "3xz63mn6fngqtiq", "description": "Supports `eid` or `userId`, `eid` is part of the user profile link, and `user_id` can be obtained from different interfaces." } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:74eb7b9da4f782ea89190ea8c32ca56a23013f3b825104dbdf6d1a5e2572ead5" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/kuaishou/app/fetch_one_user_v2?user_id=3xz63mn6fngqtiq' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-kuaishou-app-fetch_one_user_v2" } }, "/apis/v1/tikhub/kuaishou/app/fetch_one_video": { "get": { "description": "Kuaishou (app).\n\n### Purpose:\n- Fetch single video data API V1.\n### Parameters:\n- photo_id: Photo ID, the photo ID can be extracted from the share link\n - Format note: Supports both pure digital version IDs and short string version (eID) IDs, both types can be mixed.\n### Returns:\n- Video data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_kuaishou_app_fetch_one_video", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Video data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "kuaishou fetch_one_video", "tags": [ "tikhub.kuaishou" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a62abcc41ca8" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/kuaishou/app/fetch_one_video", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_kuaishou_app_fetch_one_video", "method": "GET", "path": "/apis/v1/tikhub/kuaishou/app/fetch_one_video" }, "parameters": [ { "name": "photo_id", "in": "query", "required": true, "schema": { "type": "string", "title": "Photo ID" }, "example": "3xhpk3xcf6e4iac", "description": "Photo ID, the photo ID can be extracted from the share link\n - Format note: Supports both pure digital version IDs and short string version (eID) IDs, both types can be mixed." } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:8b6f528df8aa1a0e64cf28c762f56e8c1076c4e5a2a09d47c38e148b944c4896" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/kuaishou/app/fetch_one_video?photo_id=3xhpk3xcf6e4iac' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-kuaishou-app-fetch_one_video" } }, "/apis/v1/tikhub/kuaishou/app/fetch_one_video_by_url": { "get": { "description": "Kuaishou (app).\n\n### Purpose:\n- Fetch single video by URL.\n### Parameters:\n- share_text: Photo URL or share text\n### Returns:\n- Video data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_kuaishou_app_fetch_one_video_by_url", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Video data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "kuaishou fetch_one_video_by_url", "tags": [ "tikhub.kuaishou" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "f51b1346d199" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/kuaishou/app/fetch_one_video_by_url", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_kuaishou_app_fetch_one_video_by_url", "method": "GET", "path": "/apis/v1/tikhub/kuaishou/app/fetch_one_video_by_url" }, "parameters": [ { "name": "share_text", "in": "query", "required": true, "schema": { "type": "string", "title": "Photo URL" }, "example": "https://v.kuaishou.com/cNYP0Z", "description": "Photo URL or share text" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:8b6f528df8aa1a0e64cf28c762f56e8c1076c4e5a2a09d47c38e148b944c4896" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/kuaishou/app/fetch_one_video_by_url?share_text=https%3A%2F%2Fv.kuaishou.com%2FcNYP0Z' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-kuaishou-app-fetch_one_video_by_url" } }, "/apis/v1/tikhub/kuaishou/app/fetch_selection_feed": { "get": { "description": "Kuaishou (app).\n\n### Purpose:\n- Fetch the \"Selection / Recommended\" feed of the App home page.\n- The feed has no cursor pagination; call again for more content.\n### Returns:\n- Recommended feed data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_kuaishou_app_fetch_selection_feed", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Recommended feed data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "kuaishou fetch_selection_feed", "tags": [ "tikhub.kuaishou" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "ed9f5a158dcf" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/kuaishou/app/fetch_selection_feed", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_kuaishou_app_fetch_selection_feed", "method": "GET", "path": "/apis/v1/tikhub/kuaishou/app/fetch_selection_feed" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:b6ca19c3424c4089a20b1b24a0a0f24e20ad5815dc6b4deb4449f4df4a3003e3" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-kuaishou-app-fetch_selection_feed" } }, "/apis/v1/tikhub/kuaishou/app/fetch_shopping_top_list": { "get": { "description": "Kuaishou (app).\n\n### Purpose\nGet shopping rankings.\n\n### Parameters\nUse the ID/name pair below. Chinese names are wire values and must be passed verbatim.\n\n| Category | subTabId | subTabName |\n|---|---|---|\n| Default list | 0 | Omit this optional parameter |\n| Best-selling products | 102 | `\"热销商品\"` |\n\n### Return\nRanking data.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_kuaishou_app_fetch_shopping_top_list", "responses": { "200": { "description": "Successful Response\n\n### Return\nRanking data.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "kuaishou fetch_shopping_top_list", "tags": [ "tikhub.kuaishou" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "66d80a3c8b9f" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/kuaishou/app/fetch_shopping_top_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_kuaishou_app_fetch_shopping_top_list", "method": "GET", "path": "/apis/v1/tikhub/kuaishou/app/fetch_shopping_top_list" }, "parameters": [ { "name": "subTabId", "in": "query", "required": false, "schema": { "type": "integer", "title": "Sub tag ID", "default": 0 }, "description": "Sub-list identifier. Use an ID/name pair from the endpoint table; 0 selects the default list." }, { "name": "subTabName", "in": "query", "required": false, "schema": { "type": "string", "title": "Sub tag name", "default": "" }, "description": "Sub-list name. Use the exact Chinese name paired with subTabId in the endpoint table. Omit this optional parameter for the default list." } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:fb602007f5b6c688e163da53a5ffcbc12d514a20f27e4c146d045d5cb63021db" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-kuaishou-app-fetch_shopping_top_list" } }, "/apis/v1/tikhub/kuaishou/app/fetch_tag_feed": { "get": { "description": "Kuaishou (app).\n\n### Purpose\n- Tag aggregation page: tagInfo + related feed (mixFeeds[]). Hashtag page has 4 sub tabs.\n\n### Parameters\n- general_tag_id: Tag ID. Topic tag uses tag name or search_tag's numeric id; sound tag uses encoded id.\n- tab: hot / latest / image / live\n- tag_name: Tag display name (recommended for topic tags)\n- tag_type: 1=topic tag, 29=sound/music tag\n- tag_source: 2=from search, 3=sound tag from photo page\n- from_photo_id: Source photoId (optional)\n- pcursor: Cursor, empty for first page\n\n### Returns\n- Tag info + feed data\n\nAPI references: `search_tag` = `GET /tikhub/kuaishou/app/search_tag` (operationId: `get_tikhub_kuaishou_app_search_tag`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_kuaishou_app_fetch_tag_feed", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- Tag info + feed data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "kuaishou fetch_tag_feed", "tags": [ "tikhub.kuaishou" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "d6e5d9536120" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/kuaishou/app/fetch_tag_feed", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_kuaishou_app_fetch_tag_feed", "method": "GET", "path": "/apis/v1/tikhub/kuaishou/app/fetch_tag_feed" }, "parameters": [ { "name": "from_photo_id", "in": "query", "required": false, "schema": { "type": "string", "title": "Source photo ID", "description": "Source photoId for entering the tag page (optional)" }, "description": "Source photoId for entering the tag page (optional)" }, { "name": "general_tag_id", "in": "query", "required": true, "schema": { "type": "string", "title": "Tag ID", "description": "Hashtag: pass the tag name or the numeric id from search_tag; audio tag: pass the encoded string\n\nAPI references: `search_tag` = `GET /tikhub/kuaishou/app/search_tag` (operationId: `get_tikhub_kuaishou_app_search_tag`)." }, "description": "Hashtag: pass the tag name or the numeric id from search_tag; audio tag: pass the encoded string\n\nAPI references: `search_tag` = `GET /tikhub/kuaishou/app/search_tag` (operationId: `get_tikhub_kuaishou_app_search_tag`).", "example": "清纯甜美少女" }, { "name": "pcursor", "in": "query", "required": false, "schema": { "type": "string", "title": "Pagination cursor", "description": "Leave empty for the first page, pass pcursor from the previous response for subsequent pages", "default": "" }, "description": "Leave empty for the first page, pass pcursor from the previous response for subsequent pages" }, { "name": "tab", "in": "query", "required": false, "schema": { "enum": [ "hot", "latest", "image", "live" ], "type": "string", "title": "Sub tab", "description": "hot (most popular) / latest (most recently published) / image (image posts) / live (live streams)", "default": "hot" }, "description": "hot (most popular) / latest (most recently published) / image (image posts) / live (live streams)" }, { "name": "tag_name", "in": "query", "required": false, "schema": { "type": "string", "title": "Tag name", "description": "Topic tag recommended, equal to the tag name" }, "description": "Topic tag recommended, equal to the tag name" }, { "name": "tag_source", "in": "query", "required": false, "schema": { "type": "integer", "title": "Tag source", "description": "2=entered topic page via search, 3=sound tag on post page", "default": 2 }, "description": "2=entered topic page via search, 3=sound tag on post page" }, { "name": "tag_type", "in": "query", "required": false, "schema": { "type": "integer", "title": "Tag type", "description": "1=topic hashtag, 29=sound/music tag", "default": 1 }, "description": "1=topic hashtag, 29=sound/music tag" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:386d4984d48b0375a763744a3fffacc5a55354b2c6b546ecef60c2367cbe1534" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/kuaishou/app/fetch_tag_feed?general_tag_id=%E6%B8%85%E7%BA%AF%E7%94%9C%E7%BE%8E%E5%B0%91%E5%A5%B3' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-kuaishou-app-fetch_tag_feed" } }, "/apis/v1/tikhub/kuaishou/app/fetch_user_hot_post": { "get": { "description": "Kuaishou (app).\n\n### Purpose:\n- Get user hot post data\n### Parameters:\n- user_id: User ID, this API only supports user ID, not user eid, that is, the input must be a pure digital ID.\n- user_id can be obtained from the get single user data interface.\n- pcursor: Post cursor, empty for the first request, and use the pcursor value in the returned response for subsequent requests.\n### Returns:\n- Post data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_kuaishou_app_fetch_user_hot_post", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Post data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "kuaishou fetch_user_hot_post", "tags": [ "tikhub.kuaishou" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "e1dfa9b5c0d3" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/kuaishou/app/fetch_user_hot_post", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_kuaishou_app_fetch_user_hot_post", "method": "GET", "path": "/apis/v1/tikhub/kuaishou/app/fetch_user_hot_post" }, "parameters": [ { "name": "pcursor", "in": "query", "required": false, "schema": { "type": "string", "title": "Post cursor" }, "description": "Post cursor, empty for the first request, and use the pcursor value in the returned response for subsequent requests." }, { "name": "user_id", "in": "query", "required": true, "schema": { "type": "string", "title": "User ID" }, "example": "228905802", "description": "User ID, this API only supports user ID, not user eid, that is, the input must be a pure digital ID." } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:27d1dbb7eddf0d4ceb9bb29838f6b4156aa47b55bb228b8826c5df588c5c58cd" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/kuaishou/app/fetch_user_hot_post?user_id=228905802' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-kuaishou-app-fetch_user_hot_post" } }, "/apis/v1/tikhub/kuaishou/app/fetch_user_live_info": { "get": { "description": "Kuaishou (app).\n\n### Purpose:\n- Get user live info\n### Parameters:\n- user_id: User ID, this API only supports user ID, not user eid, that is, the input must be a pure digital ID.\n- user_id can be obtained from the get single user data interface.\n### Returns:\n- Live info\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_kuaishou_app_fetch_user_live_info", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Live info", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "kuaishou fetch_user_live_info", "tags": [ "tikhub.kuaishou" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a7b98b02d7aa" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/kuaishou/app/fetch_user_live_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_kuaishou_app_fetch_user_live_info", "method": "GET", "path": "/apis/v1/tikhub/kuaishou/app/fetch_user_live_info" }, "parameters": [ { "name": "user_id", "in": "query", "required": true, "schema": { "type": "string", "title": "User ID" }, "example": "1377082950", "description": "User ID, this API only supports user ID, not user eid, that is, the input must be a pure digital ID." } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:581833140ab063b1b8176749240907b28dd1bd598a1161722b9def3f41f94a2b" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/kuaishou/app/fetch_user_live_info?user_id=1377082950' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-kuaishou-app-fetch_user_live_info" } }, "/apis/v1/tikhub/kuaishou/app/fetch_user_post_v2": { "get": { "description": "Kuaishou (app).\n\n### Purpose:\n- User video list V2\n- This API is more expensive, but more stable, please check the price list in the user background for specific prices.\n### Parameters:\n- user_id: User ID, this API only supports user ID, not user eid, that is, the input must be a pure digital ID.\n- user_id can be obtained from the get single user data interface.\n- pcursor: Video cursor, empty for the first request, and use the pcursor value in the returned response for subsequent requests.\n- sort: Sort type, latest (default) / hot.\n### Returns:\n- Videos data\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_kuaishou_app_fetch_user_post_v2", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Videos data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "kuaishou fetch_user_post", "tags": [ "tikhub.kuaishou" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a019ccc047d5" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/kuaishou/app/fetch_user_post_v2", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_kuaishou_app_fetch_user_post_v2", "method": "GET", "path": "/apis/v1/tikhub/kuaishou/app/fetch_user_post_v2" }, "parameters": [ { "name": "pcursor", "in": "query", "required": false, "schema": { "type": "string", "title": "Video cursor", "description": "Leave empty on the first request; pass the pcursor from the previous page response for subsequent requests", "default": "" }, "description": "Leave empty on the first request; pass the pcursor from the previous page response for subsequent requests" }, { "name": "sort", "in": "query", "required": false, "schema": { "enum": [ "latest", "hot" ], "type": "string", "title": "Sort type", "description": "latest (most recent, default) / hot (trending)", "default": "latest" }, "description": "latest (most recent, default) / hot (trending)" }, { "name": "user_id", "in": "query", "required": true, "schema": { "type": "string", "title": "User ID" }, "example": "903511772", "description": "User ID, this API only supports user ID, not user eid, that is, the input must be a pure digital ID." } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:751610d7794e81e152cdfa7d778833bfa55416ed599466d395eb477738b592d4" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/kuaishou/app/fetch_user_post_v2?user_id=903511772' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-kuaishou-app-fetch_user_post_v2" } }, "/apis/v1/tikhub/kuaishou/app/fetch_video_comment": { "get": { "description": "Kuaishou (app).\n\n### Purpose:\n- Fetch single video comment data\n### Parameters:\n- photo_id: Photo ID\n - Format note: Supports both pure digital version IDs and short string version (eID) IDs, both types can be mixed.\n- pcursor: Comment cursor, empty for the first request, and use the pcursor value in the returned response for subsequent requests.\n### Returns:\n- Comments data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_kuaishou_app_fetch_video_comment", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Comments data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "kuaishou fetch_video_comment", "tags": [ "tikhub.kuaishou" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "30543380b608" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/kuaishou/app/fetch_video_comment", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_kuaishou_app_fetch_video_comment", "method": "GET", "path": "/apis/v1/tikhub/kuaishou/app/fetch_video_comment" }, "parameters": [ { "name": "pcursor", "in": "query", "required": false, "schema": { "type": "string", "title": "Comment cursor" }, "description": "Comment cursor, empty for the first request, and use the pcursor value in the returned response for subsequent requests." }, { "name": "photo_id", "in": "query", "required": true, "schema": { "type": "string", "title": "Photo ID" }, "example": "3x7gxp2zhgjv832", "description": "Photo ID\n - Format note: Supports both pure digital version IDs and short string version (eID) IDs, both types can be mixed." } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:26f5c2c168073a99276fa0c658c18a23bc8d067740e68c5db5090b33922716a3" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/kuaishou/app/fetch_video_comment?photo_id=3x7gxp2zhgjv832' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-kuaishou-app-fetch_video_comment" } }, "/apis/v1/tikhub/kuaishou/app/fetch_video_sub_comments": { "get": { "description": "Kuaishou (app).\n\n### Purpose:\n- Fetch sub comments (replies) under a root comment, with cursor pagination.\n### Parameters:\n- photo_id: Photo ID\n- root_comment_id: Root comment ID\n- pcursor: Cursor, empty for first page\n- count: Page size, default 8, range 1-20\n### Returns:\n- Sub comments data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_kuaishou_app_fetch_video_sub_comments", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Sub comments data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "kuaishou fetch_video_sub_comments", "tags": [ "tikhub.kuaishou" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "c7b237436060" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/kuaishou/app/fetch_video_sub_comments", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_kuaishou_app_fetch_video_sub_comments", "method": "GET", "path": "/apis/v1/tikhub/kuaishou/app/fetch_video_sub_comments" }, "parameters": [ { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "title": "Page size", "description": "Default 8, range 1-20", "default": 8, "minimum": 1, "maximum": 20 }, "description": "Default 8, range 1-20" }, { "name": "pcursor", "in": "query", "required": false, "schema": { "type": "string", "title": "Pagination cursor", "description": "Leave empty for the first page, pass pcursor from the previous response for subsequent pages", "default": "" }, "description": "Leave empty for the first page, pass pcursor from the previous response for subsequent pages" }, { "name": "photo_id", "in": "query", "required": true, "schema": { "type": "string", "title": "Photo ID" }, "example": "5218546261880462502", "description": "Photo ID" }, { "name": "root_comment_id", "in": "query", "required": true, "schema": { "type": "string", "title": "Root comment ID" }, "example": "14000000123456789", "description": "Root comment ID" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:908e3993895cb1c0488ba9618cc0242ee46ab812a4d6aa6fe30d07423a7c4b6f" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/kuaishou/app/fetch_video_sub_comments?photo_id=5218546261880462502&root_comment_id=14000000123456789' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-kuaishou-app-fetch_video_sub_comments" } }, "/apis/v1/tikhub/kuaishou/app/fetch_videos_batch": { "get": { "description": "Kuaishou (app). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Batch fetch multiple video data, supports up to 40 video IDs per request.\n- If this API continuously fails, you can try to use the more expensive V2 API for redundant requests.\n\n### Parameters\n- photo_ids: Photo ID list, multiple IDs separated by commas, max 40 per request\n - Format note: Supports both pure digital version IDs and short string version (eID) IDs, both types can be mixed.\n\n### Returns\n- Video data list\n\n\nPublished reference price: $0.04 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_kuaishou_app_fetch_videos_batch", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Video data list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "kuaishou fetch_videos_batch", "tags": [ "tikhub.kuaishou" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.04, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "75fb431f0c89" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/kuaishou/app/fetch_videos_batch", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_kuaishou_app_fetch_videos_batch", "method": "GET", "path": "/apis/v1/tikhub/kuaishou/app/fetch_videos_batch" }, "parameters": [ { "name": "photo_ids", "in": "query", "required": true, "schema": { "type": "string", "title": "Photo ID list (comma separated)", "description": "Photo ID list, multiple IDs separated by commas, max 40 per request\n - Format note: Supports both pure digital version IDs and short string version (eID) IDs, both types can be mixed.", "pattern": "^[^,]*(?:,[^,]*){0,39}$" }, "description": "Photo ID list, multiple IDs separated by commas, max 40 per request\n - Format note: Supports both pure digital version IDs and short string version (eID) IDs, both types can be mixed.", "example": "5228960823332207296,5196309727975443273,5222486898325987583" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:1f210e4d0a00baae14a5b29ff3e69ec066deaa3391aed78faeb80f37737713cb" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/kuaishou/app/fetch_videos_batch?photo_ids=5228960823332207296%2C5196309727975443273%2C5222486898325987583' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-kuaishou-app-fetch_videos_batch" } }, "/apis/v1/tikhub/kuaishou/app/generate_kuaishou_share_link": { "get": { "description": "Kuaishou (app).\n\n### Purpose:\n- Generate Kuaishou share link\n### Parameters:\n- shareObjectId: Photo ID\n### Returns:\n- Share link\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_kuaishou_app_generate_kuaishou_share_link", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Share link", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "kuaishou generate_kuaishou_share_link", "tags": [ "tikhub.kuaishou" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "87f40fac0952" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/kuaishou/app/generate_kuaishou_share_link", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_kuaishou_app_generate_kuaishou_share_link", "method": "GET", "path": "/apis/v1/tikhub/kuaishou/app/generate_kuaishou_share_link" }, "parameters": [ { "name": "shareObjectId", "in": "query", "required": true, "schema": { "type": "string", "title": "Photo ID" }, "example": "3xg5wjqdtekbb3u", "description": "Photo ID" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:0e7b739c9e530e45802c63ca5e5090cd2eb228bb58adb4d28cac1b304e073a90" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/kuaishou/app/generate_kuaishou_share_link?shareObjectId=3xg5wjqdtekbb3u' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-kuaishou-app-generate_kuaishou_share_link" } }, "/apis/v1/tikhub/kuaishou/app/search_comprehensive": { "get": { "description": "Kuaishou (app).\n\n### Purpose:\n- Kuaishou comprehensive search API, supports searching videos, users, etc., and provides multi-dimensional filtering.\n### Parameters:\n- keyword: Search keyword (required)\n- pcursor: Pagination cursor, empty for first request, use pcursor from response for subsequent pages\n- sort_type: Sort type\n - all: Comprehensive sort (default)\n - newest: Latest release\n - most_likes: Most likes\n- publish_time: Publish time filter\n - all: All time (default)\n - one_day: Last day\n - one_week: Last week\n - one_month: Last month\n- duration: Duration filter\n - all: All duration (default)\n - under_1_min: Under 1 minute\n - 1_to_5_min: 1-5 minutes\n - over_5_min: Over 5 minutes\n### Returns:\n- Search result data\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_kuaishou_app_search_comprehensive", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Search result data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "kuaishou search_comprehensive", "tags": [ "tikhub.kuaishou" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "bff60e2fa3eb" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/kuaishou/app/search_comprehensive", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_kuaishou_app_search_comprehensive", "method": "GET", "path": "/apis/v1/tikhub/kuaishou/app/search_comprehensive" }, "parameters": [ { "name": "duration", "in": "query", "required": false, "schema": { "enum": [ "all", "under_1_min", "1_to_5_min", "over_5_min" ], "type": "string", "title": "Duration", "description": "Options: all (all), under_1_min (under 1 minute), 1_to_5_min (1-5 minutes), over_5_min (over 5 minutes)\n\nUsage: Duration filter\n - all: All duration (default)\n - under_1_min: Under 1 minute\n - 1_to_5_min: 1-5 minutes\n - over_5_min: Over 5 minutes", "default": "all" }, "description": "Options: all (all), under_1_min (under 1 minute), 1_to_5_min (1-5 minutes), over_5_min (over 5 minutes)\n\nUsage: Duration filter\n - all: All duration (default)\n - under_1_min: Under 1 minute\n - 1_to_5_min: 1-5 minutes\n - over_5_min: Over 5 minutes" }, { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "title": "Search keyword" }, "example": "Autohome", "description": "Search keyword (required)" }, { "name": "pcursor", "in": "query", "required": false, "schema": { "type": "string", "title": "Pagination cursor" }, "description": "Pagination cursor, empty for first request, use pcursor from response for subsequent pages" }, { "name": "publish_time", "in": "query", "required": false, "schema": { "enum": [ "all", "one_day", "one_week", "one_month" ], "type": "string", "title": "Publish time", "description": "Options: all (all), one_day (last 1 day), one_week (last 1 week), one_month (last 1 month)\n\nUsage: Publish time filter\n - all: All time (default)\n - one_day: Last day\n - one_week: Last week\n - one_month: Last month", "default": "all" }, "description": "Options: all (all), one_day (last 1 day), one_week (last 1 week), one_month (last 1 month)\n\nUsage: Publish time filter\n - all: All time (default)\n - one_day: Last day\n - one_week: Last week\n - one_month: Last month" }, { "name": "sort_type", "in": "query", "required": false, "schema": { "enum": [ "all", "newest", "most_likes" ], "type": "string", "title": "Sort type", "description": "Options: all (comprehensive sort), newest (latest published), most_likes (most liked)\n\nUsage: Sort type\n - all: Comprehensive sort (default)\n - newest: Latest release\n - most_likes: Most likes", "default": "all" }, "description": "Options: all (comprehensive sort), newest (latest published), most_likes (most liked)\n\nUsage: Sort type\n - all: Comprehensive sort (default)\n - newest: Latest release\n - most_likes: Most likes" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:33f0637577841a429b26da6d16181bfabb7ea8b8a11b6818d81a127d4728ff36" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/kuaishou/app/search_comprehensive?keyword=Autohome' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-kuaishou-app-search_comprehensive" } }, "/apis/v1/tikhub/kuaishou/app/search_image": { "get": { "description": "Kuaishou (app).\n\n### Purpose:\n- Search image posts by keyword, with cursor pagination.\n### Parameters:\n- keyword: Search keyword\n- pcursor: Cursor, empty for first page\n### Returns:\n- Image search results\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_kuaishou_app_search_image", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Image search results", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "kuaishou search_image", "tags": [ "tikhub.kuaishou" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "72c67ed4a9c3" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/kuaishou/app/search_image", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_kuaishou_app_search_image", "method": "GET", "path": "/apis/v1/tikhub/kuaishou/app/search_image" }, "parameters": [ { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "title": "Search keyword" }, "example": "Scenery", "description": "Search keyword" }, { "name": "pcursor", "in": "query", "required": false, "schema": { "type": "string", "title": "Pagination cursor", "description": "Leave empty for the first page, pass pcursor from the previous response for subsequent pages", "default": "" }, "description": "Leave empty for the first page, pass pcursor from the previous response for subsequent pages" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:f257e10d62402b3c60624bc331433928a0499fd1f481883f824c4cdb4fe0d5da" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/kuaishou/app/search_image?keyword=Scenery' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-kuaishou-app-search_image" } }, "/apis/v1/tikhub/kuaishou/app/search_live": { "get": { "description": "Kuaishou (app).\n\n### Purpose:\n- Search live rooms by keyword, with cursor pagination.\n### Parameters:\n- keyword: Search keyword\n- pcursor: Cursor, empty for first page\n### Returns:\n- Live search results\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_kuaishou_app_search_live", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Live search results", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "kuaishou search_live", "tags": [ "tikhub.kuaishou" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "307de2fc3835" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/kuaishou/app/search_live", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_kuaishou_app_search_live", "method": "GET", "path": "/apis/v1/tikhub/kuaishou/app/search_live" }, "parameters": [ { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "title": "Search keyword" }, "example": "Commerce / Product promotion", "description": "Search keyword" }, { "name": "pcursor", "in": "query", "required": false, "schema": { "type": "string", "title": "Pagination cursor", "description": "Leave empty for the first page, pass pcursor from the previous response for subsequent pages", "default": "" }, "description": "Leave empty for the first page, pass pcursor from the previous response for subsequent pages" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:09ba6493c1f49a7f9283132bbf60075868426f297d5106f01876006fd79f2b52" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/kuaishou/app/search_live?keyword=Commerce+%2F+Product+promotion' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-kuaishou-app-search_live" } }, "/apis/v1/tikhub/kuaishou/app/search_music": { "get": { "description": "Kuaishou (app).\n\n### Purpose:\n- Search music by keyword (song / artist), with cursor pagination.\n### Parameters:\n- keyword: Song / artist / keyword\n- pcursor: Cursor, empty for first page\n### Returns:\n- Music search results\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_kuaishou_app_search_music", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Music search results", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "kuaishou search_music", "tags": [ "tikhub.kuaishou" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "e469ca708f2a" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/kuaishou/app/search_music", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_kuaishou_app_search_music", "method": "GET", "path": "/apis/v1/tikhub/kuaishou/app/search_music" }, "parameters": [ { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "title": "Search keyword" }, "example": "Jay Chou", "description": "Song / artist / keyword" }, { "name": "pcursor", "in": "query", "required": false, "schema": { "type": "string", "title": "Pagination cursor", "description": "Leave empty for the first page, pass pcursor from the previous response for subsequent pages", "default": "" }, "description": "Leave empty for the first page, pass pcursor from the previous response for subsequent pages" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:6d2f3bf838ca661c50ee15d833d9ad090f99850e8d063611788bd447a4e6c857" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/kuaishou/app/search_music?keyword=Jay+Chou' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-kuaishou-app-search_music" } }, "/apis/v1/tikhub/kuaishou/app/search_tag": { "get": { "description": "Kuaishou (app).\n\n### Purpose\n- Search tags (hashtags) by keyword. Use /tikhub/kuaishou/app/fetch_tag_feed to browse a tag's feed.\n\n### Parameters\n- keyword: Tag keyword\n- pcursor: Cursor, empty for first page\n\n### Returns\n- Tag search results\n\nAPI references: `fetch_tag_feed` = `GET /tikhub/kuaishou/app/fetch_tag_feed` (operationId: `get_tikhub_kuaishou_app_fetch_tag_feed`).\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_kuaishou_app_search_tag", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- Tag search results", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "kuaishou search_tag", "tags": [ "tikhub.kuaishou" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "ba0c9271c4e0" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/kuaishou/app/search_tag", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_kuaishou_app_search_tag", "method": "GET", "path": "/apis/v1/tikhub/kuaishou/app/search_tag" }, "parameters": [ { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "title": "Tag keyword" }, "example": "Challenge", "description": "Tag keyword" }, { "name": "pcursor", "in": "query", "required": false, "schema": { "type": "string", "title": "Pagination cursor", "description": "Leave empty for the first page, pass pcursor from the previous response for subsequent pages", "default": "" }, "description": "Leave empty for the first page, pass pcursor from the previous response for subsequent pages" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:0adc082f70a2f277938f411c162b6cfbd7549f8d8f5e7119a2accc3983973fbb" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/kuaishou/app/search_tag?keyword=Challenge' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-kuaishou-app-search_tag" } }, "/apis/v1/tikhub/kuaishou/app/search_user_v2": { "get": { "description": "Kuaishou (app).\n\n### Purpose:\n- Search user V2\n- This API is more expensive, but more stable, please check the price list in the user background for specific prices.\n### Parameters:\n- keyword: Search keyword\n- pcursor: Pagination cursor, empty for first page, pass pcursor from previous response\n- user_relation: Relation filter, all / same_city / verified / live / following\n- user_gender: Gender filter, all / male / female\n- fans_sort: Fans sort, default / most_to_least / least_to_most\n### Returns:\n- User data\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_kuaishou_app_search_user_v2", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- User data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "kuaishou search_user", "tags": [ "tikhub.kuaishou" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "df1e9dc61b6e" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/kuaishou/app/search_user_v2", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_kuaishou_app_search_user_v2", "method": "GET", "path": "/apis/v1/tikhub/kuaishou/app/search_user_v2" }, "parameters": [ { "name": "fans_sort", "in": "query", "required": false, "schema": { "enum": [ "default", "most_to_least", "least_to_most" ], "type": "string", "title": "Fans sort", "description": "default / most_to_least / least_to_most", "default": "default" }, "description": "default / most_to_least / least_to_most" }, { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "title": "Search keyword" }, "example": "Artificial Intelligence", "description": "Search keyword" }, { "name": "pcursor", "in": "query", "required": false, "schema": { "type": "string", "title": "Pagination cursor", "description": "Empty for first page, pass pcursor from the previous response for subsequent pages", "default": "" }, "description": "Empty for first page, pass pcursor from the previous response for subsequent pages" }, { "name": "user_gender", "in": "query", "required": false, "schema": { "enum": [ "all", "male", "female" ], "type": "string", "title": "Gender filter", "description": "all / male / female", "default": "all" }, "description": "all / male / female" }, { "name": "user_relation", "in": "query", "required": false, "schema": { "enum": [ "all", "same_city", "verified", "live", "following" ], "type": "string", "title": "Relation filter", "description": "all / same_city / verified / live / following", "default": "all" }, "description": "all / same_city / verified / live / following" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:74eb7b9da4f782ea89190ea8c32ca56a23013f3b825104dbdf6d1a5e2572ead5" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/kuaishou/app/search_user_v2?keyword=Artificial+Intelligence' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-kuaishou-app-search_user_v2" } }, "/apis/v1/tikhub/kuaishou/app/search_video_v2": { "get": { "description": "Kuaishou (app).\n\n### Purpose:\n- Search video V2\n- This API is more expensive, but more stable, please check the price list in the user background for specific prices.\n### Parameters:\n- keyword: Search keyword\n- pcursor: Pagination cursor, empty for first page, pass pcursor from previous response\n### Returns:\n- Videos data\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_kuaishou_app_search_video_v2", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Videos data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "kuaishou search_video", "tags": [ "tikhub.kuaishou" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "2b0968b67c73" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/kuaishou/app/search_video_v2", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_kuaishou_app_search_video_v2", "method": "GET", "path": "/apis/v1/tikhub/kuaishou/app/search_video_v2" }, "parameters": [ { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "title": "Search keyword" }, "example": "Artificial Intelligence", "description": "Search keyword" }, { "name": "pcursor", "in": "query", "required": false, "schema": { "type": "string", "title": "Pagination cursor", "description": "Empty for first page, pass pcursor from previous response", "default": "" }, "description": "Empty for first page, pass pcursor from previous response" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:751610d7794e81e152cdfa7d778833bfa55416ed599466d395eb477738b592d4" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/kuaishou/app/search_video_v2?keyword=Artificial+Intelligence' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-kuaishou-app-search_video_v2" } }, "/apis/v1/tikhub/kuaishou/web/fetch_get_user_id": { "get": { "description": "Kuaishou (web).\n\n### Purpose:\n- Fetch user ID via user share link\n### Parameters:\n- share_link: User share link\n### Returns:\n- User ID\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_kuaishou_web_fetch_get_user_id", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- User ID", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "kuaishou fetch_get_user_id", "tags": [ "tikhub.kuaishou" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "15bed4bd2768" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/kuaishou/web/fetch_get_user_id", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_kuaishou_web_fetch_get_user_id", "method": "GET", "path": "/apis/v1/tikhub/kuaishou/web/fetch_get_user_id" }, "parameters": [ { "name": "share_link", "in": "query", "required": true, "schema": { "type": "string", "title": "User Share Link" }, "example": "https://v.kuaishou.com/KcdKDwFp", "description": "User share link" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:a7fc043ec745017c907b2746f9be557db64fbd5fca8db67884fa829564b07f62" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/kuaishou/web/fetch_get_user_id?share_link=https%3A%2F%2Fv.kuaishou.com%2FKcdKDwFp' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-kuaishou-web-fetch_get_user_id" } }, "/apis/v1/tikhub/kuaishou/web/fetch_kuaishou_hot_list_v2": { "get": { "description": "Kuaishou (web).\n\n### Purpose:\n- Fetch Kuaishou Hot List V2\n### Parameters:\n- board_type: Board Type, default is 1:\n 1 - Hot List\n 2 - Entertainment\n 3 - Society\n 4 - Useful\n 5 - Challenge\n 6 - Search\n### Returns:\n- Kuaishou Hot List V2\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_kuaishou_web_fetch_kuaishou_hot_list_v2", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Kuaishou Hot List V2", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "kuaishou fetch_kuaishou_hot_list", "tags": [ "tikhub.kuaishou" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "2a59d234a33e" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/kuaishou/web/fetch_kuaishou_hot_list_v2", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_kuaishou_web_fetch_kuaishou_hot_list_v2", "method": "GET", "path": "/apis/v1/tikhub/kuaishou/web/fetch_kuaishou_hot_list_v2" }, "parameters": [ { "name": "board_type", "in": "query", "required": false, "schema": { "type": "string", "title": "Board Type (board_type)", "default": "1" }, "example": "1", "description": "Board Type, default is 1:\n 1 - Hot List\n 2 - Entertainment\n 3 - Society\n 4 - Useful\n 5 - Challenge\n 6 - Search" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:df4de8a4a1d88395b99dbd4a0d64dee956332510c9afae258493a897d52842b7" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-kuaishou-web-fetch_kuaishou_hot_list_v2" } }, "/apis/v1/tikhub/kuaishou/web/fetch_one_video": { "get": { "description": "Kuaishou (web).\n\n### Purpose:\n- Fetch single video data, this interface does not support photo only posts.\n### Parameters:\n- share_text: Photo share link\n### Returns:\n- Video data\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_kuaishou_web_fetch_one_video", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- Video data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "kuaishou fetch_one_video", "tags": [ "tikhub.kuaishou" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "b22afd360d05" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/kuaishou/web/fetch_one_video", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_kuaishou_web_fetch_one_video", "method": "GET", "path": "/apis/v1/tikhub/kuaishou/web/fetch_one_video" }, "parameters": [ { "name": "share_text", "in": "query", "required": true, "schema": { "type": "string", "title": "Photo share link" }, "example": "https://www.kuaishou.com/f/X-f2k5KJpiXN1SY", "description": "Photo share link" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:14e7f29d1656fdabd0e3678db2ffa751397fa13097536e2cc5d666cabe47ac20" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/kuaishou/web/fetch_one_video?share_text=https%3A%2F%2Fwww.kuaishou.com%2Ff%2FX-f2k5KJpiXN1SY' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-kuaishou-web-fetch_one_video" } }, "/apis/v1/tikhub/kuaishou/web/fetch_one_video_by_url": { "get": { "description": "Kuaishou (web).\n\n### Purpose:\n- Fetch single video by URL\n### Parameters:\n- url: Photo URL\n### Returns:\n- Video data\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_kuaishou_web_fetch_one_video_by_url", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- Video data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "kuaishou fetch_one_video_by_url", "tags": [ "tikhub.kuaishou" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a9febb65fe5c" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/kuaishou/web/fetch_one_video_by_url", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_kuaishou_web_fetch_one_video_by_url", "method": "GET", "path": "/apis/v1/tikhub/kuaishou/web/fetch_one_video_by_url" }, "parameters": [ { "name": "url", "in": "query", "required": true, "schema": { "type": "string", "title": "Photo URL" }, "example": "https://v.kuaishou.com/GKTpYm", "description": "Photo URL" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:14e7f29d1656fdabd0e3678db2ffa751397fa13097536e2cc5d666cabe47ac20" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/kuaishou/web/fetch_one_video_by_url?url=https%3A%2F%2Fv.kuaishou.com%2FGKTpYm' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-kuaishou-web-fetch_one_video_by_url" } }, "/apis/v1/tikhub/kuaishou/web/fetch_one_video_comment": { "get": { "description": "Kuaishou (web).\n\n### Purpose:\n- Fetch single video comment data\n### Parameters:\n- photo_id: Photo ID\n- pcursor: Comment cursor, empty for the first request, and use the pcursor value in the returned response for subsequent requests.\n### Returns:\n- Comments data\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_kuaishou_web_fetch_one_video_comment", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Comments data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "kuaishou fetch_one_video_comment", "tags": [ "tikhub.kuaishou" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "f0560c3d4dee" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/kuaishou/web/fetch_one_video_comment", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_kuaishou_web_fetch_one_video_comment", "method": "GET", "path": "/apis/v1/tikhub/kuaishou/web/fetch_one_video_comment" }, "parameters": [ { "name": "pcursor", "in": "query", "required": false, "schema": { "type": "string", "title": "Comment cursor" }, "description": "Comment cursor, empty for the first request, and use the pcursor value in the returned response for subsequent requests." }, { "name": "photo_id", "in": "query", "required": true, "schema": { "type": "string", "title": "Photo ID" }, "example": "3x7gxp2zhgjv832", "description": "Photo ID" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:26f5c2c168073a99276fa0c658c18a23bc8d067740e68c5db5090b33922716a3" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/kuaishou/web/fetch_one_video_comment?photo_id=3x7gxp2zhgjv832' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-kuaishou-web-fetch_one_video_comment" } }, "/apis/v1/tikhub/kuaishou/web/fetch_one_video_sub_comment": { "get": { "description": "Kuaishou (web).\n\n### Purpose:\n- Fetch single video comment data\n### Parameters:\n- photo_id: Photo ID\n- pcursor: Comment cursor, empty for the first request, and use the pcursor value in the returned response for subsequent requests.\n- root_comment_id: Root comment ID\n### Returns:\n- Comments data\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_kuaishou_web_fetch_one_video_sub_comment", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Comments data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "kuaishou fetch_one_video_sub_comment", "tags": [ "tikhub.kuaishou" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "cb68e63aa62a" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/kuaishou/web/fetch_one_video_sub_comment", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_kuaishou_web_fetch_one_video_sub_comment", "method": "GET", "path": "/apis/v1/tikhub/kuaishou/web/fetch_one_video_sub_comment" }, "parameters": [ { "name": "pcursor", "in": "query", "required": false, "schema": { "type": "string", "title": "Comment cursor", "default": "" }, "example": "909377053156", "description": "Comment cursor, empty for the first request, and use the pcursor value in the returned response for subsequent requests." }, { "name": "photo_id", "in": "query", "required": true, "schema": { "type": "string", "title": "Photo ID" }, "example": "3xgarycnydawq3g", "description": "Photo ID" }, { "name": "root_comment_id", "in": "query", "required": true, "schema": { "type": "string", "title": "Root comment ID" }, "example": "908850553827", "description": "Root comment ID" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:26f5c2c168073a99276fa0c658c18a23bc8d067740e68c5db5090b33922716a3" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/kuaishou/web/fetch_one_video_sub_comment?pcursor=909377053156&photo_id=3xgarycnydawq3g&root_comment_id=908850553827' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-kuaishou-web-fetch_one_video_sub_comment" } }, "/apis/v1/tikhub/kuaishou/web/fetch_user_collect": { "get": { "description": "Kuaishou (web).\n\n### Purpose:\n- Fetch user favorite\n- Note: This API requires the user's eid, which can be extracted from the user's profile URL.\n- For example: In the URL https://www.kuaishou.com/profile/3xz63mn6fngqtiq, the eid is 3xz63mn6fngqtiq.\n- Note: Querying with uid (pure numeric user ID) is not supported.\n### Parameters:\n- user_id: User ID\n- pcursor: Post cursor, empty for the first request, and use the pcursor value in the returned response for subsequent requests.\n### Returns:\n- User favorite list\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_kuaishou_web_fetch_user_collect", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- User favorite list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "kuaishou fetch_user_collect", "tags": [ "tikhub.kuaishou" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "32adcfa41f02" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/kuaishou/web/fetch_user_collect", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_kuaishou_web_fetch_user_collect", "method": "GET", "path": "/apis/v1/tikhub/kuaishou/web/fetch_user_collect" }, "parameters": [ { "name": "pcursor", "in": "query", "required": false, "schema": { "type": "string", "title": "Post cursor" }, "description": "Post cursor, empty for the first request, and use the pcursor value in the returned response for subsequent requests." }, { "name": "user_id", "in": "query", "required": true, "schema": { "type": "string", "title": "User ID (eid)" }, "example": "3xz63mn6fngqtiq", "description": "User ID" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:bff799cad03cba0adfbb303c945ff960284897e4924d982c3400eaaa6793bceb" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/kuaishou/web/fetch_user_collect?user_id=3xz63mn6fngqtiq' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-kuaishou-web-fetch_user_collect" } }, "/apis/v1/tikhub/kuaishou/web/fetch_user_info": { "get": { "description": "Kuaishou (web). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Fetch user info\n - Note: This API requires the user's eid, which can be extracted from the user's profile URL.\n - For example: In the URL https://www.kuaishou.com/profile/3xz63mn6fngqtiq, the eid is 3xz63mn6fngqtiq.\n - Note: Querying with uid (pure numeric user ID) is not supported.\n - Note: Please set the timeout to more than 30 seconds when making requests to this API, otherwise it may cause the client to not receive the response in time and result in billing.\n - Due to the special nature of risk control for this API, we try to keep it stable, but we still cannot guarantee 100% stability. If you encounter a request failure, please try again later.\n\n### Parameters\n- user_id: User ID\n\n### Returns\n- User info, including nickname, avatar, number of followers, number of followings, number\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_kuaishou_web_fetch_user_info", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- User info, including nickname, avatar, number of followers, number of followings, number", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "kuaishou fetch_user_info", "tags": [ "tikhub.kuaishou" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "e0278f2be601" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/kuaishou/web/fetch_user_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_kuaishou_web_fetch_user_info", "method": "GET", "path": "/apis/v1/tikhub/kuaishou/web/fetch_user_info" }, "parameters": [ { "name": "user_id", "in": "query", "required": true, "schema": { "type": "string", "title": "User ID (eid)" }, "example": "3xz63mn6fngqtiq", "description": "User ID" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:33b889ea6248d0bbbbefaf1da78e09eee76ed002ae70dbef99f1e39ce8a46d98" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/kuaishou/web/fetch_user_info?user_id=3xz63mn6fngqtiq' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-kuaishou-web-fetch_user_info" } }, "/apis/v1/tikhub/kuaishou/web/fetch_user_live_replay": { "get": { "description": "Kuaishou (web).\n\n### Purpose:\n- Fetch user live replay\n- Note: This API requires the user's eid, which can be extracted from the user's profile URL.\n- For example: In the URL https://www.kuaishou.com/profile/3xz63mn6fngqtiq, the eid is 3xz63mn6fngqtiq.\n- Note: Querying with uid (pure numeric user ID) is not supported.\n### Parameters:\n- user_id: User ID\n- pcursor: Post cursor, empty for the first request, and use the pcursor value in the returned response for subsequent requests.\n### Returns:\n- User live replay list\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_kuaishou_web_fetch_user_live_replay", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- User live replay list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "kuaishou fetch_user_live_replay", "tags": [ "tikhub.kuaishou" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "1dd3a17ca149" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/kuaishou/web/fetch_user_live_replay", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_kuaishou_web_fetch_user_live_replay", "method": "GET", "path": "/apis/v1/tikhub/kuaishou/web/fetch_user_live_replay" }, "parameters": [ { "name": "pcursor", "in": "query", "required": false, "schema": { "type": "string", "title": "Post cursor" }, "description": "Post cursor, empty for the first request, and use the pcursor value in the returned response for subsequent requests." }, { "name": "user_id", "in": "query", "required": true, "schema": { "type": "string", "title": "User ID (eid)" }, "example": "3xz63mn6fngqtiq", "description": "User ID" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:a9655fb8df793c44dcba95c20a597e4ced6fc015ff9db2e884223207d1cd7941" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/kuaishou/web/fetch_user_live_replay?user_id=3xz63mn6fngqtiq' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-kuaishou-web-fetch_user_live_replay" } }, "/apis/v1/tikhub/kuaishou/web/generate_share_short_url": { "get": { "description": "Kuaishou (web).\n\n### Purpose:\n- Generate share short URL\n### Parameters:\n- photo_id: Photo ID\n### Returns:\n- Short URL\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_kuaishou_web_generate_share_short_url", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Short URL", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "kuaishou generate_share_short_url", "tags": [ "tikhub.kuaishou" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "d7aefa62d5f7" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/kuaishou/web/generate_share_short_url", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_kuaishou_web_generate_share_short_url", "method": "GET", "path": "/apis/v1/tikhub/kuaishou/web/generate_share_short_url" }, "parameters": [ { "name": "photo_id", "in": "query", "required": true, "schema": { "type": "string", "title": "Photo ID" }, "example": "3xtdqvdnqd3psuc", "description": "Photo ID" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:edebf308d7e8234c215261ea79ba88718d0ae03ca8b9668f0952ce85408cf212" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/kuaishou/web/generate_share_short_url?photo_id=3xtdqvdnqd3psuc' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-kuaishou-web-generate_share_short_url" } }, "/apis/v1/tikhub/lemon8/app/fetch_discover_banners": { "get": { "description": "Lemon8 (app).\n\n### Purpose:\n- Get banners of discover page\n### Return:\n- Banners list\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_lemon8_app_fetch_discover_banners", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Banners list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "lemon8 fetch_discover_banners", "tags": [ "tikhub.lemon8" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "36d487a24947" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/lemon8/app/fetch_discover_banners", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_lemon8_app_fetch_discover_banners", "method": "GET", "path": "/apis/v1/tikhub/lemon8/app/fetch_discover_banners" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:416a103e3b3f2e76b322f9b4cc11d0976b67bbb6048776599357b72d29a07f5a" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-lemon8-app-fetch_discover_banners" } }, "/apis/v1/tikhub/lemon8/app/fetch_discover_tab": { "get": { "description": "Lemon8 (app).\n\n### Purpose:\n- Get main content of discover page\n### Return:\n- Main content\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_lemon8_app_fetch_discover_tab", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Main content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "lemon8 fetch_discover_tab", "tags": [ "tikhub.lemon8" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "fca259b62f7d" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/lemon8/app/fetch_discover_tab", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_lemon8_app_fetch_discover_tab", "method": "GET", "path": "/apis/v1/tikhub/lemon8/app/fetch_discover_tab" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:242fe254cd82a4a328e6890dfc2efe58e2adae198cddddb13b0816a075a157f0" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-lemon8-app-fetch_discover_tab" } }, "/apis/v1/tikhub/lemon8/app/fetch_discover_tab_information_tabs": { "get": { "description": "Lemon8 (app).\n\n### Purpose:\n- Get Editor's Picks of discover page\n### Return:\n- Editor's Picks\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_lemon8_app_fetch_discover_tab_information_tabs", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Editor's Picks", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "lemon8 fetch_discover_tab_information_tabs", "tags": [ "tikhub.lemon8" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "148d2b6d14ea" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/lemon8/app/fetch_discover_tab_information_tabs", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_lemon8_app_fetch_discover_tab_information_tabs", "method": "GET", "path": "/apis/v1/tikhub/lemon8/app/fetch_discover_tab_information_tabs" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:d3011d450eb8c23366c6f69075a7d6045bb1f3d9bb6fc1ea667302a13eb7910d" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-lemon8-app-fetch_discover_tab_information_tabs" } }, "/apis/v1/tikhub/lemon8/app/fetch_hot_search_keywords": { "get": { "description": "Lemon8 (app).\n\n### Purpose:\n- Get hot search keywords\n### Return:\n- Hot search keywords list\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_lemon8_app_fetch_hot_search_keywords", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Hot search keywords list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "lemon8 fetch_hot_search_keywords", "tags": [ "tikhub.lemon8" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a8c9f667d87f" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/lemon8/app/fetch_hot_search_keywords", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_lemon8_app_fetch_hot_search_keywords", "method": "GET", "path": "/apis/v1/tikhub/lemon8/app/fetch_hot_search_keywords" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:bd37976e176bb10b035f647f36d36b743fc5a33c4acd109e113eeea85f6ffbc3" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-lemon8-app-fetch_hot_search_keywords" } }, "/apis/v1/tikhub/lemon8/app/fetch_post_comment_list": { "get": { "description": "Lemon8 (app).\n\n### Purpose\n- Get comments list of specified post\n\n### Parameters\n- group_id: Post's group_id, can be obtained from the interface `/tikhub/lemon8/app/fetch_post_detail`\n- item_id: Post's item_id, can be obtained from the interface `/tikhub/lemon8/app/fetch_post_detail` or `/tikhub/lemon8/app/get_item_id`\n- media_id: Post's media_id, can be obtained from the interface `/tikhub/lemon8/app/fetch_post_detail`\n- offset: Pagination parameter, can be obtained from the return result of the last request. It is empty for the first request, and the offset returned by the last request is used for subsequent requests.\n\n### Return\n- Comments list\n\nAPI references: `fetch_post_detail` = `GET /tikhub/lemon8/app/fetch_post_detail` (operationId: `get_tikhub_lemon8_app_fetch_post_detail`); `get_item_id` = `GET /tikhub/lemon8/app/get_item_id` (operationId: `get_tikhub_lemon8_app_get_item_id`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_lemon8_app_fetch_post_comment_list", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Comments list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "lemon8 fetch_post_comment_list", "tags": [ "tikhub.lemon8" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "e748785daf04" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/lemon8/app/fetch_post_comment_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_lemon8_app_fetch_post_comment_list", "method": "GET", "path": "/apis/v1/tikhub/lemon8/app/fetch_post_comment_list" }, "parameters": [ { "name": "group_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Post's group_id, can be obtained from the interface `/tikhub/lemon8/app/fetch_post_detail`\n\nAPI references: `fetch_post_detail` = `GET /tikhub/lemon8/app/fetch_post_detail` (operationId: `get_tikhub_lemon8_app_fetch_post_detail`).", "title": "Group Id" }, "description": "Post's group_id, can be obtained from the interface `/tikhub/lemon8/app/fetch_post_detail`\n\nAPI references: `fetch_post_detail` = `GET /tikhub/lemon8/app/fetch_post_detail` (operationId: `get_tikhub_lemon8_app_fetch_post_detail`).", "example": "7361926875709129222" }, { "name": "item_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Post's item_id, can be obtained from the interface `/tikhub/lemon8/app/fetch_post_detail` or `/tikhub/lemon8/app/get_item_id`\n\nAPI references: `fetch_post_detail` = `GET /tikhub/lemon8/app/fetch_post_detail` (operationId: `get_tikhub_lemon8_app_fetch_post_detail`); `get_item_id` = `GET /tikhub/lemon8/app/get_item_id` (operationId: `get_tikhub_lemon8_app_get_item_id`).", "title": "Item Id" }, "description": "Post's item_id, can be obtained from the interface `/tikhub/lemon8/app/fetch_post_detail` or `/tikhub/lemon8/app/get_item_id`\n\nAPI references: `fetch_post_detail` = `GET /tikhub/lemon8/app/fetch_post_detail` (operationId: `get_tikhub_lemon8_app_fetch_post_detail`); `get_item_id` = `GET /tikhub/lemon8/app/get_item_id` (operationId: `get_tikhub_lemon8_app_get_item_id`).", "example": "7361926875709129222" }, { "name": "media_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Post's media_id, can be obtained from the interface `/tikhub/lemon8/app/fetch_post_detail`\n\nAPI references: `fetch_post_detail` = `GET /tikhub/lemon8/app/fetch_post_detail` (operationId: `get_tikhub_lemon8_app_fetch_post_detail`).", "title": "Media Id" }, "description": "Post's media_id, can be obtained from the interface `/tikhub/lemon8/app/fetch_post_detail`\n\nAPI references: `fetch_post_detail` = `GET /tikhub/lemon8/app/fetch_post_detail` (operationId: `get_tikhub_lemon8_app_fetch_post_detail`).", "example": "7428056850216862763" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination parameter, can be obtained from the return result of the last request. It is empty for the first request, and the offset returned by the last request is used for subsequent requests.", "default": "0", "title": "Offset" }, "description": "Pagination parameter, can be obtained from the return result of the last request. It is empty for the first request, and the offset returned by the last request is used for subsequent requests.", "example": "0" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:250bc42043d32cb795af071aae04401a47f8d113b54cecd97996464e470fc483" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/lemon8/app/fetch_post_comment_list?group_id=7361926875709129222&item_id=7361926875709129222&media_id=7428056850216862763&offset=0' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-lemon8-app-fetch_post_comment_list" } }, "/apis/v1/tikhub/lemon8/app/fetch_post_detail": { "get": { "description": "Lemon8 (app).\n\n### Purpose\n- Get information of specified post\n\n### Parameters\n- item_id: Post ID, can be obtained from the interface `/tikhub/lemon8/app/get_item_id`\n\n### Return\n- Post information\n\nAPI references: `get_item_id` = `GET /tikhub/lemon8/app/get_item_id` (operationId: `get_tikhub_lemon8_app_get_item_id`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_lemon8_app_fetch_post_detail", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Post information", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "lemon8 fetch_post_detail", "tags": [ "tikhub.lemon8" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "2c7fd8f7e286" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/lemon8/app/fetch_post_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_lemon8_app_fetch_post_detail", "method": "GET", "path": "/apis/v1/tikhub/lemon8/app/fetch_post_detail" }, "parameters": [ { "name": "item_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Post ID, can be obtained from the interface `/tikhub/lemon8/app/get_item_id`\n\nAPI references: `get_item_id` = `GET /tikhub/lemon8/app/get_item_id` (operationId: `get_tikhub_lemon8_app_get_item_id`).", "title": "Item Id" }, "description": "Post ID, can be obtained from the interface `/tikhub/lemon8/app/get_item_id`\n\nAPI references: `get_item_id` = `GET /tikhub/lemon8/app/get_item_id` (operationId: `get_tikhub_lemon8_app_get_item_id`).", "example": "7361926875709129222" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:763354e9ee3d397ec2028941837018d6ea8590d0d6df4c28b0dc0171a536fa0b" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/lemon8/app/fetch_post_detail?item_id=7361926875709129222' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-lemon8-app-fetch_post_detail" } }, "/apis/v1/tikhub/lemon8/app/fetch_search": { "get": { "description": "Lemon8 (app).\n\n### Purpose:\n- Search API\n### Parameters:\n- query: Search keyword\n- max_cursor: Pagination parameter, can be obtained from the return result of the last request. It is empty for the first request, and the `max_cursor` returned by the last request is used for subsequent requests. You can judge whether there is more data by the `has_more` field in the return result.\n- filter_type: Search filter type, default is an empty string, optional values are as follows:\n - Empty string: All (default using this parameter to search)\n - video: Search only video\n - posts: Search only posts\n- order_by: Search sort type, default is an empty string, optional values are as follows:\n - Empty string: Relevance (default using this parameter to sort)\n - popular: Sort by popularity\n - recent: Sort from new to old\n- search_tab: Search type, default is `main`, optional values are as follows:\n - main: Display as `Top` in the APP (comprehensive search, default using this parameter to search)\n - user: Display as `Accounts` in the APP (search user accounts)\n - hashtag: Display as `Hashtags` in the APP (search hashtags)\n - article: Display as `Posts` in the APP (search articles)\n### Return:\n- Search results\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_lemon8_app_fetch_search", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Search results", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "lemon8 fetch_search", "tags": [ "tikhub.lemon8" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "f6f982106be8" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/lemon8/app/fetch_search", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_lemon8_app_fetch_search", "method": "GET", "path": "/apis/v1/tikhub/lemon8/app/fetch_search" }, "parameters": [ { "name": "filter_type", "in": "query", "required": false, "schema": { "type": "string", "description": "Search filter type, default is an empty string, optional values are as follows:\n - Empty string: All (default using this parameter to search)\n - video: Search only video\n - posts: Search only posts", "default": "", "title": "Filter Type" }, "description": "Search filter type, default is an empty string, optional values are as follows:\n - Empty string: All (default using this parameter to search)\n - video: Search only video\n - posts: Search only posts", "example": "" }, { "name": "max_cursor", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination parameter, can be obtained from the return result of the last request. It is empty for the first request, and the `max_cursor` returned by the last request is used for subsequent requests. You can judge whether there is more data by the `has_more` field in the return result.", "default": "", "title": "Max Cursor" }, "description": "Pagination parameter, can be obtained from the return result of the last request. It is empty for the first request, and the `max_cursor` returned by the last request is used for subsequent requests. You can judge whether there is more data by the `has_more` field in the return result.", "example": "" }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "description": "Search sort type, default is an empty string, optional values are as follows:\n - Empty string: Relevance (default using this parameter to sort)\n - popular: Sort by popularity\n - recent: Sort from new to old", "default": "", "title": "Order By" }, "description": "Search sort type, default is an empty string, optional values are as follows:\n - Empty string: Relevance (default using this parameter to sort)\n - popular: Sort by popularity\n - recent: Sort from new to old", "example": "" }, { "name": "query", "in": "query", "required": true, "schema": { "type": "string", "description": "Search keyword", "title": "Query" }, "description": "Search keyword", "example": "lemon8" }, { "name": "search_tab", "in": "query", "required": false, "schema": { "type": "string", "description": "Search type, default is `main`, optional values are as follows:\n - main: Display as `Top` in the APP (comprehensive search, default using this parameter to search)\n - user: Display as `Accounts` in the APP (search user accounts)\n - hashtag: Display as `Hashtags` in the APP (search hashtags)\n - article: Display as `Posts` in the APP (search articles)", "default": "main", "title": "Search Tab" }, "description": "Search type, default is `main`, optional values are as follows:\n - main: Display as `Top` in the APP (comprehensive search, default using this parameter to search)\n - user: Display as `Accounts` in the APP (search user accounts)\n - hashtag: Display as `Hashtags` in the APP (search hashtags)\n - article: Display as `Posts` in the APP (search articles)", "example": "main" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:ba2f9de6dd24c70aaa17b05c2f822e005f7b260ef9969a9b4f018207fac76ce9" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/lemon8/app/fetch_search?filter_type=&max_cursor=&order_by=&query=lemon8&search_tab=main' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-lemon8-app-fetch_search" } }, "/apis/v1/tikhub/lemon8/app/fetch_topic_info": { "get": { "description": "Lemon8 (app).\n\n### Purpose\n- Get topic information\n\n### Parameters\n- forum_id: Topic ID, can be obtained from the following interfaces\n - Get information of specified post: `/tikhub/lemon8/app/fetch_post_detail`\n - Get Editor's Picks of discover page: `/tikhub/lemon8/app/fetch_discover_tab_information_tabs`\n - Search Hashtag through interface: `/tikhub/lemon8/app/fetch_search?search_tab=hashtag&keyword=lemon8`\n\n### Return\n- Topic information\n\nAPI references: `fetch_discover_tab_information_tabs` = `GET /tikhub/lemon8/app/fetch_discover_tab_information_tabs` (operationId: `get_tikhub_lemon8_app_fetch_discover_tab_information_tabs`); `fetch_post_detail` = `GET /tikhub/lemon8/app/fetch_post_detail` (operationId: `get_tikhub_lemon8_app_fetch_post_detail`); `fetch_search` = `GET /tikhub/lemon8/app/fetch_search` (operationId: `get_tikhub_lemon8_app_fetch_search`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_lemon8_app_fetch_topic_info", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Topic information", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "lemon8 fetch_topic_info", "tags": [ "tikhub.lemon8" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "b4452b4e503a" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/lemon8/app/fetch_topic_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_lemon8_app_fetch_topic_info", "method": "GET", "path": "/apis/v1/tikhub/lemon8/app/fetch_topic_info" }, "parameters": [ { "name": "forum_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Topic ID, can be obtained from the following interfaces\n - Get information of specified post: `/tikhub/lemon8/app/fetch_post_detail`\n - Get Editor's Picks of discover page: `/tikhub/lemon8/app/fetch_discover_tab_information_tabs`\n - Search Hashtag through interface: `/tikhub/lemon8/app/fetch_search?search_tab=hashtag&keyword=lemon8`\n\nAPI references: `fetch_discover_tab_information_tabs` = `GET /tikhub/lemon8/app/fetch_discover_tab_information_tabs` (operationId: `get_tikhub_lemon8_app_fetch_discover_tab_information_tabs`); `fetch_post_detail` = `GET /tikhub/lemon8/app/fetch_post_detail` (operationId: `get_tikhub_lemon8_app_fetch_post_detail`); `fetch_search` = `GET /tikhub/lemon8/app/fetch_search` (operationId: `get_tikhub_lemon8_app_fetch_search`).", "title": "Forum Id" }, "description": "Topic ID, can be obtained from the following interfaces\n - Get information of specified post: `/tikhub/lemon8/app/fetch_post_detail`\n - Get Editor's Picks of discover page: `/tikhub/lemon8/app/fetch_discover_tab_information_tabs`\n - Search Hashtag through interface: `/tikhub/lemon8/app/fetch_search?search_tab=hashtag&keyword=lemon8`\n\nAPI references: `fetch_discover_tab_information_tabs` = `GET /tikhub/lemon8/app/fetch_discover_tab_information_tabs` (operationId: `get_tikhub_lemon8_app_fetch_discover_tab_information_tabs`); `fetch_post_detail` = `GET /tikhub/lemon8/app/fetch_post_detail` (operationId: `get_tikhub_lemon8_app_fetch_post_detail`); `fetch_search` = `GET /tikhub/lemon8/app/fetch_search` (operationId: `get_tikhub_lemon8_app_fetch_search`).", "example": "7174447913778593798" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:8780a95e24b7efd2c92c57a4a845058fcef956763a30c9c71b2dcc2d9367b6a0" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/lemon8/app/fetch_topic_info?forum_id=7174447913778593798' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-lemon8-app-fetch_topic_info" } }, "/apis/v1/tikhub/lemon8/app/fetch_topic_post_list": { "get": { "description": "Lemon8 (app).\n\n### Purpose\n- Get topic post list\n\n### Parameters\n- category: Topic category ID, can be obtained from the interface `/tikhub/lemon8/app/fetch_topic_info`\n- max_behot_time: Pagination parameter, can be obtained from the return result of the last request. It is empty for the first request, and the max_behot_time returned by the last request is used for subsequent requests.\n- category_parameter: Category parameter ID, can be obtained from the interface `/tikhub/lemon8/app/fetch_topic_info`\n- hashtag_name: Hashtag name, can be obtained from the interface `/tikhub/lemon8/app/fetch_topic_info`\n- sort_type: Sort type, 0 for default sort, currently only support default sort, please do not pass other values.\n\n### Return\n- Post list\n\nAPI references: `fetch_topic_info` = `GET /tikhub/lemon8/app/fetch_topic_info` (operationId: `get_tikhub_lemon8_app_fetch_topic_info`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_lemon8_app_fetch_topic_post_list", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Post list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "lemon8 fetch_topic_post_list", "tags": [ "tikhub.lemon8" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "fd8ff33952d5" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/lemon8/app/fetch_topic_post_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_lemon8_app_fetch_topic_post_list", "method": "GET", "path": "/apis/v1/tikhub/lemon8/app/fetch_topic_post_list" }, "parameters": [ { "name": "category", "in": "query", "required": true, "schema": { "type": "string", "description": "Topic category ID, can be obtained from the interface `/tikhub/lemon8/app/fetch_topic_info`\n\nAPI references: `fetch_topic_info` = `GET /tikhub/lemon8/app/fetch_topic_info` (operationId: `get_tikhub_lemon8_app_fetch_topic_info`).", "title": "Category" }, "description": "Topic category ID, can be obtained from the interface `/tikhub/lemon8/app/fetch_topic_info`\n\nAPI references: `fetch_topic_info` = `GET /tikhub/lemon8/app/fetch_topic_info` (operationId: `get_tikhub_lemon8_app_fetch_topic_info`).", "example": "590" }, { "name": "category_parameter", "in": "query", "required": true, "schema": { "type": "string", "description": "Category parameter ID, can be obtained from the interface `/tikhub/lemon8/app/fetch_topic_info`\n\nAPI references: `fetch_topic_info` = `GET /tikhub/lemon8/app/fetch_topic_info` (operationId: `get_tikhub_lemon8_app_fetch_topic_info`).", "title": "Category Parameter" }, "description": "Category parameter ID, can be obtained from the interface `/tikhub/lemon8/app/fetch_topic_info`\n\nAPI references: `fetch_topic_info` = `GET /tikhub/lemon8/app/fetch_topic_info` (operationId: `get_tikhub_lemon8_app_fetch_topic_info`).", "example": "7174447913778593798" }, { "name": "hashtag_name", "in": "query", "required": true, "schema": { "type": "string", "description": "Hashtag name, can be obtained from the interface `/tikhub/lemon8/app/fetch_topic_info`\n\nAPI references: `fetch_topic_info` = `GET /tikhub/lemon8/app/fetch_topic_info` (operationId: `get_tikhub_lemon8_app_fetch_topic_info`).", "title": "Hashtag Name" }, "description": "Hashtag name, can be obtained from the interface `/tikhub/lemon8/app/fetch_topic_info`\n\nAPI references: `fetch_topic_info` = `GET /tikhub/lemon8/app/fetch_topic_info` (operationId: `get_tikhub_lemon8_app_fetch_topic_info`).", "example": "lemon8christmas" }, { "name": "max_behot_time", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination parameter, can be obtained from the return result of the last request. It is empty for the first request, and the max_behot_time returned by the last request is used for subsequent requests.", "default": "", "title": "Max Behot Time" }, "description": "Pagination parameter, can be obtained from the return result of the last request. It is empty for the first request, and the max_behot_time returned by the last request is used for subsequent requests.", "example": "" }, { "name": "sort_type", "in": "query", "required": false, "schema": { "type": "string", "description": "Sort type, 0 for default sort, currently only support default sort, please do not pass other values.", "default": "0", "title": "Sort Type" }, "description": "Sort type, 0 for default sort, currently only support default sort, please do not pass other values." } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:91a1ca2ece42a16a4dc9d3fddc43a8ed14ae8f9e22bee158f226132f909a368d" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/lemon8/app/fetch_topic_post_list?category=590&category_parameter=7174447913778593798&hashtag_name=lemon8christmas&max_behot_time=' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-lemon8-app-fetch_topic_post_list" } }, "/apis/v1/tikhub/lemon8/app/fetch_user_follower_list": { "get": { "description": "Lemon8 (app).\n\n### Purpose\n- Get fans list of specified user\n\n### Parameters\n- user_id: User ID, can be obtained from the interface `/tikhub/lemon8/app/get_user_id`\n- cursor: Pagination parameter, can be obtained from the return result of the last request. It is empty for the first request, and the cursor returned by the last request is used for subsequent requests.\n\n### Return\n- Fans list\n\nAPI references: `get_user_id` = `GET /tikhub/lemon8/app/get_user_id` (operationId: `get_tikhub_lemon8_app_get_user_id`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_lemon8_app_fetch_user_follower_list", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Fans list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "lemon8 fetch_user_follower_list", "tags": [ "tikhub.lemon8" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "4b53ff8f3986" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/lemon8/app/fetch_user_follower_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_lemon8_app_fetch_user_follower_list", "method": "GET", "path": "/apis/v1/tikhub/lemon8/app/fetch_user_follower_list" }, "parameters": [ { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination parameter, can be obtained from the return result of the last request. It is empty for the first request, and the cursor returned by the last request is used for subsequent requests.", "default": "", "title": "Cursor" }, "description": "Pagination parameter, can be obtained from the return result of the last request. It is empty for the first request, and the cursor returned by the last request is used for subsequent requests.", "example": "" }, { "name": "user_id", "in": "query", "required": true, "schema": { "type": "string", "description": "User ID, can be obtained from the interface `/tikhub/lemon8/app/get_user_id`\n\nAPI references: `get_user_id` = `GET /tikhub/lemon8/app/get_user_id` (operationId: `get_tikhub_lemon8_app_get_user_id`).", "title": "User Id" }, "description": "User ID, can be obtained from the interface `/tikhub/lemon8/app/get_user_id`\n\nAPI references: `get_user_id` = `GET /tikhub/lemon8/app/get_user_id` (operationId: `get_tikhub_lemon8_app_get_user_id`).", "example": "7428056850216862763" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e6bb3beadff0c2c949d89c2d70dbe6e8a48ef134256887ff83c8aa85f38c05b4" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/lemon8/app/fetch_user_follower_list?cursor=&user_id=7428056850216862763' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-lemon8-app-fetch_user_follower_list" } }, "/apis/v1/tikhub/lemon8/app/fetch_user_following_list": { "get": { "description": "Lemon8 (app).\n\n### Purpose\n- Get following list of specified user\n\n### Parameters\n- user_id: User ID, can be obtained from the interface `/tikhub/lemon8/app/get_user_id`\n- cursor: Pagination parameter, can be obtained from the return result of the last request. It is empty for the first request, and the cursor returned by the last request is used for subsequent requests.\n\n### Return\n- Following list\n\nAPI references: `get_user_id` = `GET /tikhub/lemon8/app/get_user_id` (operationId: `get_tikhub_lemon8_app_get_user_id`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_lemon8_app_fetch_user_following_list", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Following list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "lemon8 fetch_user_following_list", "tags": [ "tikhub.lemon8" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "6fd6e04742f4" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/lemon8/app/fetch_user_following_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_lemon8_app_fetch_user_following_list", "method": "GET", "path": "/apis/v1/tikhub/lemon8/app/fetch_user_following_list" }, "parameters": [ { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination parameter, can be obtained from the return result of the last request. It is empty for the first request, and the cursor returned by the last request is used for subsequent requests.", "default": "", "title": "Cursor" }, "description": "Pagination parameter, can be obtained from the return result of the last request. It is empty for the first request, and the cursor returned by the last request is used for subsequent requests.", "example": "" }, { "name": "user_id", "in": "query", "required": true, "schema": { "type": "string", "description": "User ID, can be obtained from the interface `/tikhub/lemon8/app/get_user_id`\n\nAPI references: `get_user_id` = `GET /tikhub/lemon8/app/get_user_id` (operationId: `get_tikhub_lemon8_app_get_user_id`).", "title": "User Id" }, "description": "User ID, can be obtained from the interface `/tikhub/lemon8/app/get_user_id`\n\nAPI references: `get_user_id` = `GET /tikhub/lemon8/app/get_user_id` (operationId: `get_tikhub_lemon8_app_get_user_id`).", "example": "7428056850216862763" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:a67fa68940ac66b4a83671235b40d3cd9322f04766a3ad37e5577faa162db4a0" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/lemon8/app/fetch_user_following_list?cursor=&user_id=7428056850216862763' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-lemon8-app-fetch_user_following_list" } }, "/apis/v1/tikhub/lemon8/app/fetch_user_profile": { "get": { "description": "Lemon8 (app).\n\n### Purpose\n- Get information of specified user\n\n### Parameters\n- user_id: User ID, can be obtained from the interface `/tikhub/lemon8/app/get_user_id`\n\n### Return\n- User information\n\nAPI references: `get_user_id` = `GET /tikhub/lemon8/app/get_user_id` (operationId: `get_tikhub_lemon8_app_get_user_id`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_lemon8_app_fetch_user_profile", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- User information", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "lemon8 fetch_user_profile", "tags": [ "tikhub.lemon8" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "855e5db80054" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/lemon8/app/fetch_user_profile", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_lemon8_app_fetch_user_profile", "method": "GET", "path": "/apis/v1/tikhub/lemon8/app/fetch_user_profile" }, "parameters": [ { "name": "user_id", "in": "query", "required": true, "schema": { "type": "string", "description": "User ID, can be obtained from the interface `/tikhub/lemon8/app/get_user_id`\n\nAPI references: `get_user_id` = `GET /tikhub/lemon8/app/get_user_id` (operationId: `get_tikhub_lemon8_app_get_user_id`).", "title": "User Id" }, "description": "User ID, can be obtained from the interface `/tikhub/lemon8/app/get_user_id`\n\nAPI references: `get_user_id` = `GET /tikhub/lemon8/app/get_user_id` (operationId: `get_tikhub_lemon8_app_get_user_id`).", "example": "7217844966059656197" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:341539e411b93db6baa5bed99c92d549d02d8e735420963c120d407a371ff36a" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/lemon8/app/fetch_user_profile?user_id=7217844966059656197' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-lemon8-app-fetch_user_profile" } }, "/apis/v1/tikhub/lemon8/app/get_item_id": { "get": { "description": "Lemon8 (app).\n\n### Purpose:\n- Get post ID through sharing link\n### Parameters:\n- share_text: Share link, supports long links and short links, can be obtained and copied from the share button on the web and APP.\n### Return:\n- Post ID\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_lemon8_app_get_item_id", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Post ID", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "lemon8 get_item_id", "tags": [ "tikhub.lemon8" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "e43ba9339b05" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/lemon8/app/get_item_id", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_lemon8_app_get_item_id", "method": "GET", "path": "/apis/v1/tikhub/lemon8/app/get_item_id" }, "parameters": [ { "name": "share_text", "in": "query", "required": true, "schema": { "type": "string", "description": "Share link, supports long links and short links, can be obtained and copied from the share button on the web and APP.", "title": "Share Text" }, "description": "Share link, supports long links and short links, can be obtained and copied from the share button on the web and APP.", "example": "https://v.lemon8-app.com/al/OghwFTppx" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:ac2daf3390ad351a804e6f0881611019c64ef67fcede524022c7f3fa51151939" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/lemon8/app/get_item_id?share_text=https%3A%2F%2Fv.lemon8-app.com%2Fal%2FOghwFTppx' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-lemon8-app-get_item_id" } }, "/apis/v1/tikhub/lemon8/app/get_item_ids": { "post": { "description": "Lemon8 (app).\n\n### Purpose\n- Get post IDs in batch through sharing links, up to 10 at a time\n\n### Parameters\n- Root JSON body: Share links list, supports long links and short links, can be obtained and copied from the share button on the web and APP.\n\n### Return\n- Post IDs list\n\n### Request body\nSend the request body as a JSON array of strings at the root.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_lemon8_app_get_item_ids", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Post IDs list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "lemon8 get_item_ids", "tags": [ "tikhub.lemon8" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "6d446832ce7e" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/lemon8/app/get_item_ids", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_lemon8_app_get_item_ids", "method": "POST", "path": "/apis/v1/tikhub/lemon8/app/get_item_ids" }, "requestBody": { "content": { "application/json": { "schema": { "items": {}, "type": "array", "title": "Share Texts", "description": "Share links list Send the request body as a JSON array of strings at the root." }, "example": [ "https://www.lemon8-app.com/@deathlabs_/7445613324903006766", "https://v.lemon8-app.com/al/OghwFTppx" ] } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:33967369997e4ed033afa44a3814a66d31592e95b8741a4c49f59ba22f5e73f3" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/lemon8/app/get_item_ids \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '[\n \"https://www.lemon8-app.com/@deathlabs_/7445613324903006766\",\n \"https://v.lemon8-app.com/al/OghwFTppx\"\n]'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-lemon8-app-get_item_ids" } }, "/apis/v1/tikhub/lemon8/app/get_user_id": { "get": { "description": "Lemon8 (app).\n\n### Purpose:\n- Get user ID through sharing link\n### Parameters:\n- share_text: Share link, supports long links and short links, can be obtained and copied from the share button on the web and APP.\n### Return:\n- User ID\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_lemon8_app_get_user_id", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- User ID", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "lemon8 get_user_id", "tags": [ "tikhub.lemon8" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "2a475b345b66" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/lemon8/app/get_user_id", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_lemon8_app_get_user_id", "method": "GET", "path": "/apis/v1/tikhub/lemon8/app/get_user_id" }, "parameters": [ { "name": "share_text", "in": "query", "required": true, "schema": { "type": "string", "description": "Share link, supports long links and short links, can be obtained and copied from the share button on the web and APP.", "title": "Share Text" }, "description": "Share link, supports long links and short links, can be obtained and copied from the share button on the web and APP.", "example": "https://v.lemon8-app.com/al/OgZrsUppx" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:d08b9bcf6e815f311516a942132cc37936203c0c903aaf8ba85e81d748d1b06f" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/lemon8/app/get_user_id?share_text=https%3A%2F%2Fv.lemon8-app.com%2Fal%2FOgZrsUppx' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-lemon8-app-get_user_id" } }, "/apis/v1/tikhub/lemon8/app/get_user_ids": { "post": { "description": "Lemon8 (app).\n\n### Purpose\n- Get user IDs in batch through sharing links, up to 10 at a time\n\n### Parameters\n- Root JSON body: Share links list, supports long links and short links, can be obtained and copied from the share button on the web and APP.\n\n### Return\n- User IDs list\n\n### Request body\nSend the request body as a JSON array of strings at the root.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_lemon8_app_get_user_ids", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- User IDs list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "lemon8 get_user_ids", "tags": [ "tikhub.lemon8" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "7fafbfcef206" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/lemon8/app/get_user_ids", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_lemon8_app_get_user_ids", "method": "POST", "path": "/apis/v1/tikhub/lemon8/app/get_user_ids" }, "requestBody": { "content": { "application/json": { "schema": { "items": {}, "type": "array", "title": "Share Texts", "description": "Share links list Send the request body as a JSON array of strings at the root." }, "example": [ "https://www.lemon8-app.com/lemon8cars?region=us", "https://v.lemon8-app.com/al/OgZrsUppx" ] } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:5c77501a55e0fb3302651252a4ec322a9698cce18acd97fbfe47971fc60db282" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/lemon8/app/get_user_ids \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '[\n \"https://www.lemon8-app.com/lemon8cars?region=us\",\n \"https://v.lemon8-app.com/al/OgZrsUppx\"\n]'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-lemon8-app-get_user_ids" } }, "/apis/v1/tikhub/linkedin/web_v2/get_company_posts": { "get": { "description": "Linkedin (web_v2).\n\n### Purpose:\n- Fetch a company's posts by company URL.\n\n### Parameters:\n- url: Company URL.\n- start: Pagination offset — 0 for page 1, 50 for page 2, and so on.\n- pagination_token: Token from the `paging` object of the previous response.\n- sort_by: top or recent.\n\n### Returns:\n- data: list of posts; paging: pagination info (count / start /\n pagination_token).\n\n\nPublished reference price: $0.05 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_linkedin_web_v2_get_company_posts", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- data: list of posts; paging: pagination info (count / start /\n pagination_token).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "linkedin get_company_posts", "tags": [ "tikhub.linkedin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web_v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.05, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "ef730da7d3ec" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/linkedin/web_v2/get_company_posts", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_linkedin_web_v2_get_company_posts", "method": "GET", "path": "/apis/v1/tikhub/linkedin/web_v2/get_company_posts" }, "parameters": [ { "name": "pagination_token", "in": "query", "required": false, "schema": { "description": "Pagination token\n\nUsage: Token from the `paging` object of the previous response.", "title": "Pagination Token", "type": [ "string", "null" ] }, "description": "Pagination token\n\nUsage: Token from the `paging` object of the previous response." }, { "name": "sort_by", "in": "query", "required": false, "schema": { "description": "top | recent", "title": "Sort By", "type": [ "string", "null" ] }, "description": "top | recent" }, { "name": "start", "in": "query", "required": false, "schema": { "description": "Pagination offset — 0 for page 1, 50 for page 2, and so on.", "title": "Start", "type": [ "integer", "null" ], "minimum": 0 }, "description": "Pagination offset — 0 for page 1, 50 for page 2, and so on." }, { "name": "url", "in": "query", "required": true, "schema": { "type": "string", "description": "Company URL", "title": "Url" }, "description": "Company URL", "example": "https://www.linkedin.com/company/microsoft/" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:dd24f56819182ce2d6014f3540cfaf9e9414afcd3225978cbe1b49accfc5e383" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/linkedin/web_v2/get_company_posts?url=https%3A%2F%2Fwww.linkedin.com%2Fcompany%2Fmicrosoft%2F' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-linkedin-web_v2-get_company_posts" } }, "/apis/v1/tikhub/linkedin/web_v2/get_company_profile": { "get": { "description": "Linkedin (web_v2).\n\n### Purpose:\n- Fetch a company's profile by URL.\n\n### Parameters:\n- url: Full company URL (e.g. https://www.linkedin.com/company/microsoft/).\n\n### Returns:\n- Public fields such as company name, about, size, industry, headquarters,\n follower count and affiliated pages.\n\n\nPublished reference price: $0.008 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_linkedin_web_v2_get_company_profile", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- Public fields such as company name, about, size, industry, headquarters,\n follower count and affiliated pages.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "linkedin get_company_profile", "tags": [ "tikhub.linkedin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web_v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.008, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a96c762b9caf" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/linkedin/web_v2/get_company_profile", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_linkedin_web_v2_get_company_profile", "method": "GET", "path": "/apis/v1/tikhub/linkedin/web_v2/get_company_profile" }, "parameters": [ { "name": "url", "in": "query", "required": true, "schema": { "type": "string", "description": "Full company URL (e.g. https://www.linkedin.com/company/microsoft/).", "title": "Url" }, "description": "Full company URL (e.g. https://www.linkedin.com/company/microsoft/).", "example": "https://www.linkedin.com/company/microsoft/" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:9533c6ee7ce6ba927d49fbaba41700e4322879ca2849f18b8b140be750c4677c" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/linkedin/web_v2/get_company_profile?url=https%3A%2F%2Fwww.linkedin.com%2Fcompany%2Fmicrosoft%2F' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-linkedin-web_v2-get_company_profile" } }, "/apis/v1/tikhub/linkedin/web_v2/get_job_detail": { "get": { "description": "Linkedin (web_v2).\n\n### Purpose:\n- Fetch a job posting by its URL.\n\n### Parameters:\n- url: Job URL, e.g. https://www.linkedin.com/jobs/view/3766410207/.\n- include_skills: Whether to include the required skills.\n- include_hiring_team: Whether to include hiring team information.\n\n### Returns:\n- data: job title, description, company profile, salary range, location,\n skills and more.\n\n\nPublished reference price: $0.05 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_linkedin_web_v2_get_job_detail", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- data: job title, description, company profile, salary range, location,\n skills and more.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "linkedin get_job_detail", "tags": [ "tikhub.linkedin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web_v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.05, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "4ad4c112bc9e" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/linkedin/web_v2/get_job_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_linkedin_web_v2_get_job_detail", "method": "GET", "path": "/apis/v1/tikhub/linkedin/web_v2/get_job_detail" }, "parameters": [ { "name": "include_hiring_team", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Include hiring team", "default": false, "title": "Include Hiring Team" }, "description": "Include hiring team" }, { "name": "include_skills", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether to include the required skills.", "default": false, "title": "Include Skills" }, "description": "Whether to include the required skills." }, { "name": "url", "in": "query", "required": true, "schema": { "type": "string", "description": "Job URL, e.g. https://www.linkedin.com/jobs/view/3766410207/.", "title": "Url" }, "description": "Job URL, e.g. https://www.linkedin.com/jobs/view/3766410207/.", "example": "https://www.linkedin.com/jobs/view/software-engineer-at-pave-4310512612/" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e3a261de1919f3f003f70468b9a55e936994719f2b794e3b48a087831874ac29" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/linkedin/web_v2/get_job_detail?url=https%3A%2F%2Fwww.linkedin.com%2Fjobs%2Fview%2Fsoftware-engineer-at-pave-4310512612%2F' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-linkedin-web_v2-get_job_detail" } }, "/apis/v1/tikhub/linkedin/web_v2/get_post_comments": { "get": { "description": "Linkedin (web_v2).\n\n### Purpose:\n- Fetch comments of a post by its activity urn.\n\n### Parameters:\n- urn: Post activity urn (the numeric part of .../urn:li:activity:/).\n- sort_by: Most relevant (default) or Most recent.\n- page: Page number, starting at 1.\n- pagination_token: Token returned by the previous response.\n- share_urn: Optional share urn for shared posts.\n\n### Returns:\n- data: list of comments (commenter, text, time, pinned flag, replies, …);\n pagination_token: token for the next page; total: number of items\n returned.\n\n\nPublished reference price: $0.05 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_linkedin_web_v2_get_post_comments", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- data: list of comments (commenter, text, time, pinned flag, replies, …);\n pagination_token: token for the next page; total: number of items\n returned.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "linkedin get_post_comments", "tags": [ "tikhub.linkedin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web_v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.05, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "c22c3753f3ab" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/linkedin/web_v2/get_post_comments", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_linkedin_web_v2_get_post_comments", "method": "GET", "path": "/apis/v1/tikhub/linkedin/web_v2/get_post_comments" }, "parameters": [ { "name": "page", "in": "query", "required": false, "schema": { "description": "Page number, starts at 1", "title": "Page", "type": [ "integer", "null" ], "minimum": 1 }, "description": "Page number, starts at 1" }, { "name": "pagination_token", "in": "query", "required": false, "schema": { "description": "Pagination token", "title": "Pagination Token", "type": [ "string", "null" ] }, "description": "Pagination token" }, { "name": "share_urn", "in": "query", "required": false, "schema": { "description": "Share urn (optional", "title": "Share Urn", "type": [ "string", "null" ] }, "description": "Share urn (optional" }, { "name": "sort_by", "in": "query", "required": false, "schema": { "description": "Most recent", "title": "Sort By", "type": [ "string", "null" ] }, "description": "Most recent" }, { "name": "urn", "in": "query", "required": true, "schema": { "type": "string", "description": "Post activity urn (the numeric part of .../urn:li:activity:/).", "title": "Urn" }, "description": "Post activity urn (the numeric part of .../urn:li:activity:/).", "example": "7267273010393358336" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:8c08c1e10ecee921b52910b49fe4aa41655c9116101a66a9aac8f33bb686eb95" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/linkedin/web_v2/get_post_comments?urn=7267273010393358336' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-linkedin-web_v2-get_post_comments" } }, "/apis/v1/tikhub/linkedin/web_v2/get_post_detail": { "get": { "description": "Linkedin (web_v2).\n\n### Purpose:\n- Fetch a post or an article by URL.\n\n### Parameters:\n- url: Full post or article URL (both /posts/... and /pulse/... are\n supported).\n\n### Returns:\n- Fields such as body text, author, posted time, hashtags, images / video\n and engagement counts.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_linkedin_web_v2_get_post_detail", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- Fields such as body text, author, posted time, hashtags, images / video\n and engagement counts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "linkedin get_post_detail", "tags": [ "tikhub.linkedin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web_v2", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "305767bd7ff7" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/linkedin/web_v2/get_post_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_linkedin_web_v2_get_post_detail", "method": "GET", "path": "/apis/v1/tikhub/linkedin/web_v2/get_post_detail" }, "parameters": [ { "name": "url", "in": "query", "required": true, "schema": { "type": "string", "description": "Full post or article URL (both /posts... and /pulse... are\n supported).", "title": "Url" }, "description": "Full post or article URL (both /posts... and /pulse... are\n supported).", "example": "https://www.linkedin.com/posts/orlenchner_scrapecon-activity-7180537307521769472-oSYN" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:3583dc39daf098ffaebc8e772a2039f75ae6b9e62a246ddc3647822d239430b4" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/linkedin/web_v2/get_post_detail?url=https%3A%2F%2Fwww.linkedin.com%2Fposts%2Forlenchner_scrapecon-activity-7180537307521769472-oSYN' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-linkedin-web_v2-get_post_detail" } }, "/apis/v1/tikhub/linkedin/web_v2/get_user_posts": { "get": { "description": "Linkedin (web_v2).\n\n### Purpose:\n- Fetch a member's posts, commented posts, or reacted posts by profile URL.\n\n### Parameters:\n- url: Profile URL.\n- type: posts / comments / reactions. Defaults to posts.\n- start: Pagination offset — 0 for page 1, 50 for page 2, and so on.\n- pagination_token: Token from the `paging` object of the previous response.\n\n### Returns:\n- data: list of posts; paging: pagination info (count / start /\n pagination_token).\n\n\nPublished reference price: $0.05 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_linkedin_web_v2_get_user_posts", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- data: list of posts; paging: pagination info (count / start /\n pagination_token).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "linkedin get_user_posts", "tags": [ "tikhub.linkedin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web_v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.05, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "ddc774847b22" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/linkedin/web_v2/get_user_posts", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_linkedin_web_v2_get_user_posts", "method": "GET", "path": "/apis/v1/tikhub/linkedin/web_v2/get_user_posts" }, "parameters": [ { "name": "pagination_token", "in": "query", "required": false, "schema": { "description": "Pagination token\n\nUsage: Token from the `paging` object of the previous response.", "title": "Pagination Token", "type": [ "string", "null" ] }, "description": "Pagination token\n\nUsage: Token from the `paging` object of the previous response." }, { "name": "start", "in": "query", "required": false, "schema": { "description": "Pagination offset — 0 for page 1, 50 for page 2, and so on.", "title": "Start", "type": [ "integer", "null" ], "minimum": 0 }, "description": "Pagination offset — 0 for page 1, 50 for page 2, and so on." }, { "name": "type", "in": "query", "required": false, "schema": { "type": "string", "description": "posts / | comments | reactions", "default": "posts", "title": "Type" }, "description": "posts / | comments | reactions" }, { "name": "url", "in": "query", "required": true, "schema": { "type": "string", "description": "Profile URL", "title": "Url" }, "description": "Profile URL", "example": "https://www.linkedin.com/in/williamhgates/" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:dd24f56819182ce2d6014f3540cfaf9e9414afcd3225978cbe1b49accfc5e383" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/linkedin/web_v2/get_user_posts?url=https%3A%2F%2Fwww.linkedin.com%2Fin%2Fwilliamhgates%2F' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-linkedin-web_v2-get_user_posts" } }, "/apis/v1/tikhub/linkedin/web_v2/get_user_profile": { "get": { "description": "Linkedin (web_v2).\n\n### Purpose:\n- Fetch a LinkedIn member's public profile by URL.\n\n### Parameters:\n- url: Full profile URL (e.g. https://www.linkedin.com/in/williamhgates/).\n\n### Returns:\n- Public fields such as name, current company, about, location, follower\n count, experience and education.\n\n\nPublished reference price: $0.008 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_linkedin_web_v2_get_user_profile", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- Public fields such as name, current company, about, location, follower\n count, experience and education.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "linkedin get_user_profile", "tags": [ "tikhub.linkedin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web_v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.008, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "dbd5cbf86db4" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/linkedin/web_v2/get_user_profile", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_linkedin_web_v2_get_user_profile", "method": "GET", "path": "/apis/v1/tikhub/linkedin/web_v2/get_user_profile" }, "parameters": [ { "name": "url", "in": "query", "required": true, "schema": { "type": "string", "description": "Full profile URL (e.g. https://www.linkedin.com/in/williamhgates/).", "title": "Url" }, "description": "Full profile URL (e.g. https://www.linkedin.com/in/williamhgates/).", "example": "https://www.linkedin.com/in/williamhgates/" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:450073b5b3f74ba7652b4c438285d684bf72970d12fca6097da13a419603f3dd" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/linkedin/web_v2/get_user_profile?url=https%3A%2F%2Fwww.linkedin.com%2Fin%2Fwilliamhgates%2F' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-linkedin-web_v2-get_user_profile" } }, "/apis/v1/tikhub/linkedin/web_v2/search_jobs": { "get": { "description": "Linkedin (web_v2).\n\n### Purpose:\n- Search jobs by keywords and filters.\n\n### Parameters:\n- keywords: Search keywords.\n- geo_code: LinkedIn geo code. Defaults to 92000000 (worldwide).\n- date_posted / sort_by: Posting-time filter and sort order.\n- experience_levels / company_ids / title_ids / onsite_remotes / functions /\n industries / job_types: List filters — repeat the same parameter to pass\n multiple values.\n- start: Pagination offset — 0 for page 1, 25 for page 2, and so on.\n\n### Returns:\n- data: list of jobs (company, title, location, salary, posted time, …);\n total: total number of results.\n\n\nPublished reference price: $0.05 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_linkedin_web_v2_search_jobs", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- data: list of jobs (company, title, location, salary, posted time, …);\n total: total number of results.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "linkedin search_jobs", "tags": [ "tikhub.linkedin" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web_v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.05, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "b89b033f2ede" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/linkedin/web_v2/search_jobs", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_linkedin_web_v2_search_jobs", "method": "GET", "path": "/apis/v1/tikhub/linkedin/web_v2/search_jobs" }, "parameters": [ { "name": "company_ids", "in": "query", "required": false, "schema": { "description": "Company ids, repeatable", "title": "Company Ids", "type": [ "array", "null" ], "items": { "type": "integer" } }, "description": "Company ids, repeatable" }, { "name": "date_posted", "in": "query", "required": false, "schema": { "description": "Any time / Past month / Past week / Past 24 hours", "title": "Date Posted", "type": [ "string", "null" ] }, "description": "Any time / Past month / Past week / Past 24 hours" }, { "name": "easy_apply", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Easy-apply jobs only", "default": false, "title": "Easy Apply" }, "description": "Easy-apply jobs only" }, { "name": "experience_levels", "in": "query", "required": false, "schema": { "description": "Internship / Entry level / Associate / Mid-Senior level / Director / Executive", "title": "Experience Levels", "type": [ "array", "null" ], "items": { "type": "string" } }, "description": "Internship / Entry level / Associate / Mid-Senior level / Director / Executive" }, { "name": "functions", "in": "query", "required": false, "schema": { "description": "Functions, repeatable", "title": "Functions", "type": [ "array", "null" ], "items": { "type": "string" } }, "description": "Functions, repeatable" }, { "name": "geo_code", "in": "query", "required": false, "schema": { "description": "LinkedIn geo code, 92000000 = worldwide", "default": 92000000, "title": "Geo Code", "type": [ "integer", "null" ] }, "description": "LinkedIn geo code, 92000000 = worldwide" }, { "name": "industries", "in": "query", "required": false, "schema": { "description": "Industries, repeatable", "title": "Industries", "type": [ "array", "null" ], "items": { "type": "string" } }, "description": "Industries, repeatable" }, { "name": "job_types", "in": "query", "required": false, "schema": { "description": "Full-time / Part-time / Contract / Temporary / Internship / Volunteer", "title": "Job Types", "type": [ "array", "null" ], "items": { "type": "string" } }, "description": "Full-time / Part-time / Contract / Temporary / Internship / Volunteer" }, { "name": "keywords", "in": "query", "required": false, "schema": { "description": "Keywords", "title": "Keywords", "type": [ "string", "null" ] }, "description": "Keywords", "example": "data analyst" }, { "name": "onsite_remotes", "in": "query", "required": false, "schema": { "description": "On-site / Remote / Hybrid", "title": "Onsite Remotes", "type": [ "array", "null" ], "items": { "type": "string" } }, "description": "On-site / Remote / Hybrid" }, { "name": "sort_by", "in": "query", "required": false, "schema": { "description": "Most relevant / Most recent", "title": "Sort By", "type": [ "string", "null" ] }, "description": "Most relevant / Most recent" }, { "name": "start", "in": "query", "required": false, "schema": { "description": "Pagination offset — 0 for page 1, 25 for page 2, and so on.", "title": "Start", "type": [ "integer", "null" ], "minimum": 0 }, "description": "Pagination offset — 0 for page 1, 25 for page 2, and so on." }, { "name": "title_ids", "in": "query", "required": false, "schema": { "description": "Title ids, repeatable", "title": "Title Ids", "type": [ "array", "null" ], "items": { "type": "integer" } }, "description": "Title ids, repeatable" }, { "name": "under_10_applicants", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Under 10 applicants only", "default": false, "title": "Under 10 Applicants" }, "description": "Under 10 applicants only" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:c8b643bf8d98d5bb340000d3c9b2c01813fe023bacc79bf16f0384fd7eed377a" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-linkedin-web_v2-search_jobs" } }, "/apis/v1/tikhub/pipixia/app/fetch_hashtag_detail": { "get": { "description": "Pipixia (app).\n\n### Purpose:\n- Get hashtag detail data.\n### Parameters:\n- hashtag_id: AKA hashtag id, can be obtained from the share link.\n### Return:\n- Hashtag detail data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_pipixia_app_fetch_hashtag_detail", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Hashtag detail data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "pipixia fetch_hashtag_detail", "tags": [ "tikhub.pipixia" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "1e6172ac3289" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/pipixia/app/fetch_hashtag_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_pipixia_app_fetch_hashtag_detail", "method": "GET", "path": "/apis/v1/tikhub/pipixia/app/fetch_hashtag_detail" }, "parameters": [ { "name": "hashtag_id", "in": "query", "required": true, "schema": { "type": "string", "description": "AKA hashtag id, can be obtained from the share link.", "title": "Hashtag Id" }, "description": "AKA hashtag id, can be obtained from the share link.", "example": "129559" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:97e117a71e3d840aa6b19ebd97a8324dca44c57c58368b08d51468c240d8ac44" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/pipixia/app/fetch_hashtag_detail?hashtag_id=129559' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-pipixia-app-fetch_hashtag_detail" } }, "/apis/v1/tikhub/pipixia/app/fetch_hashtag_post_list": { "get": { "description": "Pipixia (app).\n\n### Purpose\n- Get hashtag post list data.\n\n### Parameters\n- hashtag_id: AKA hashtag id, can be obtained from the share link.\n- cursor: Page cursor, default is 0, get the corresponding value from the `loadmore_cursor` Key in the previous page.\n- feed_count: Page count, default is 0, add 1 for each page, such as 0 for the first page, 1 for the second page, 2 for the third page, and so on.\n\n### Return\n- Hashtag post list data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_pipixia_app_fetch_hashtag_post_list", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Hashtag post list data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "pipixia fetch_hashtag_post_list", "tags": [ "tikhub.pipixia" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "532fccd04302" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/pipixia/app/fetch_hashtag_post_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_pipixia_app_fetch_hashtag_post_list", "method": "GET", "path": "/apis/v1/tikhub/pipixia/app/fetch_hashtag_post_list" }, "parameters": [ { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "description": "Page cursor", "default": "0", "title": "Cursor" }, "description": "Page cursor", "example": "0" }, { "name": "feed_count", "in": "query", "required": false, "schema": { "type": "string", "description": "Page count", "default": "0", "title": "Feed Count" }, "description": "Page count", "example": "0" }, { "name": "hashtag_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Hashtag id", "title": "Hashtag Id" }, "description": "Hashtag id", "example": "129559" }, { "name": "hashtag_request_type", "in": "query", "required": false, "schema": { "type": "string", "description": "Hashtag request type: 0=popular (default), 1=latest, 2=featured.", "default": "0", "title": "Hashtag Request Type" }, "description": "Hashtag request type: 0=popular (default), 1=latest, 2=featured.", "example": "0" }, { "name": "hashtag_sort_type", "in": "query", "required": false, "schema": { "type": "string", "description": "Hashtag sort type: 3=popularity (default), 2=newest first, 1=featured.", "default": "3", "title": "Hashtag Sort Type" }, "description": "Hashtag sort type: 3=popularity (default), 2=newest first, 1=featured.", "example": "3" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:c91f50fe8d0321b19d3077239df5c3ac2f9c5f8b77077ec7f14fa8b353cb741b" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/pipixia/app/fetch_hashtag_post_list?cursor=0&feed_count=0&hashtag_id=129559&hashtag_request_type=0&hashtag_sort_type=3' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-pipixia-app-fetch_hashtag_post_list" } }, "/apis/v1/tikhub/pipixia/app/fetch_home_feed": { "get": { "description": "Pipixia (app).\n\n### Purpose:\n- Get home feed data.\n### Parameters:\n- cursor: Page cursor, default is 0, get the corresponding value from the `loadmore_cursor` Key in the previous page.\n### Return:\n- Home feed data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_pipixia_app_fetch_home_feed", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Home feed data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "pipixia fetch_home_feed", "tags": [ "tikhub.pipixia" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "1ba9612dcba7" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/pipixia/app/fetch_home_feed", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_pipixia_app_fetch_home_feed", "method": "GET", "path": "/apis/v1/tikhub/pipixia/app/fetch_home_feed" }, "parameters": [ { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "description": "Page cursor, default is 0, get the corresponding value from the `loadmore_cursor` Key in the previous page.", "default": "0", "title": "Cursor" }, "description": "Page cursor, default is 0, get the corresponding value from the `loadmore_cursor` Key in the previous page.", "example": "0" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:3929e064c7f131f5a91a55e4f97aef235237275a2b375ef54c8fc7e2b29e3df8" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-pipixia-app-fetch_home_feed" } }, "/apis/v1/tikhub/pipixia/app/fetch_home_short_drama_feed": { "get": { "description": "Pipixia (app).\n\n### Purpose:\n- Get home short drama feed data.\n### Parameters:\n- page: Page number, default is 1, add 1 for each page.\n### Return:\n- Home short drama feed data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_pipixia_app_fetch_home_short_drama_feed", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Home short drama feed data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "pipixia fetch_home_short_drama_feed", "tags": [ "tikhub.pipixia" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "4f3d141c36e7" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/pipixia/app/fetch_home_short_drama_feed", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_pipixia_app_fetch_home_short_drama_feed", "method": "GET", "path": "/apis/v1/tikhub/pipixia/app/fetch_home_short_drama_feed" }, "parameters": [ { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page number, default is 1, add 1 for each page.", "default": 1, "title": "Page" }, "description": "Page number, default is 1, add 1 for each page.", "example": 1 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:b7726a0cb9534bfbd940bf9f57c6ba034892de1686d00f9d04fe64cbe80ef10d" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-pipixia-app-fetch_home_short_drama_feed" } }, "/apis/v1/tikhub/pipixia/app/fetch_hot_search_board_detail": { "get": { "description": "Pipixia (app).\n\n### Purpose\n- Get hot search board detail data.\n\n### Parameters\n- block_type: Board type, can be obtained from the `/tikhub/pipixia/app/fetch_hot_search_board_list` interface.\n\n### Return\n- Hot search board detail data\n\nAPI references: `fetch_hot_search_board_list` = `GET /tikhub/pipixia/app/fetch_hot_search_board_list` (operationId: `get_tikhub_pipixia_app_fetch_hot_search_board_list`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_pipixia_app_fetch_hot_search_board_detail", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Hot search board detail data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "pipixia fetch_hot_search_board_detail", "tags": [ "tikhub.pipixia" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "4529de2d7004" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/pipixia/app/fetch_hot_search_board_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_pipixia_app_fetch_hot_search_board_detail", "method": "GET", "path": "/apis/v1/tikhub/pipixia/app/fetch_hot_search_board_detail" }, "parameters": [ { "name": "block_type", "in": "query", "required": true, "schema": { "type": "integer", "description": "Board type, can be obtained from the `/tikhub/pipixia/app/fetch_hot_search_board_list` interface.\n\nAPI references: `fetch_hot_search_board_list` = `GET /tikhub/pipixia/app/fetch_hot_search_board_list` (operationId: `get_tikhub_pipixia_app_fetch_hot_search_board_list`).", "title": "Block Type" }, "description": "Board type, can be obtained from the `/tikhub/pipixia/app/fetch_hot_search_board_list` interface.\n\nAPI references: `fetch_hot_search_board_list` = `GET /tikhub/pipixia/app/fetch_hot_search_board_list` (operationId: `get_tikhub_pipixia_app_fetch_hot_search_board_list`).", "example": 12 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:d9067dc010444423ea203d49ae6fde81c7356fcb9dd25ef5d5afcef1cc5da3cd" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/pipixia/app/fetch_hot_search_board_detail?block_type=12' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-pipixia-app-fetch_hot_search_board_detail" } }, "/apis/v1/tikhub/pipixia/app/fetch_hot_search_board_list": { "get": { "description": "Pipixia (app).\n\n### Purpose:\n- Get hot search board list data.\n### Return:\n- Hot search board list data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_pipixia_app_fetch_hot_search_board_list", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Hot search board list data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "pipixia fetch_hot_search_board_list", "tags": [ "tikhub.pipixia" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "5b20f093df93" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/pipixia/app/fetch_hot_search_board_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_pipixia_app_fetch_hot_search_board_list", "method": "GET", "path": "/apis/v1/tikhub/pipixia/app/fetch_hot_search_board_list" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:1ffe3a101b367b97284cea963d25935e62bc79dcfadaca25584f84900602a734" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-pipixia-app-fetch_hot_search_board_list" } }, "/apis/v1/tikhub/pipixia/app/fetch_hot_search_words": { "get": { "description": "Pipixia (app).\n\n### Purpose:\n- Get hot search words data.\n### Return:\n- Hot search words data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_pipixia_app_fetch_hot_search_words", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Hot search words data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "pipixia fetch_hot_search_words", "tags": [ "tikhub.pipixia" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "d52ced8710c0" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/pipixia/app/fetch_hot_search_words", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_pipixia_app_fetch_hot_search_words", "method": "GET", "path": "/apis/v1/tikhub/pipixia/app/fetch_hot_search_words" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:aada1783c7f1ac5d629ee7636d06c63ad0abf0adf02916b52ec911b6ac458d52" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-pipixia-app-fetch_hot_search_words" } }, "/apis/v1/tikhub/pipixia/app/fetch_increase_post_view_count": { "get": { "description": "Pipixia (app).\n\n### Purpose:\n- Increase post view count.\n### Parameters:\n- cell_id: AKA video id, can be obtained from the share link.\n- cell_type: Video type, 1 for video, keep the default value for other types.\n### Return:\n- Execution result\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_pipixia_app_fetch_increase_post_view_count", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Execution result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "pipixia fetch_increase_post_view_count", "tags": [ "tikhub.pipixia" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "29b417aa529d" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/pipixia/app/fetch_increase_post_view_count", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_pipixia_app_fetch_increase_post_view_count", "method": "GET", "path": "/apis/v1/tikhub/pipixia/app/fetch_increase_post_view_count" }, "parameters": [ { "name": "cell_id", "in": "query", "required": true, "schema": { "type": "string", "description": "AKA video id, can be obtained from the share link.", "title": "Cell Id" }, "description": "AKA video id, can be obtained from the share link.", "example": "7411193113223371043" }, { "name": "cell_type", "in": "query", "required": false, "schema": { "type": "integer", "description": "Video type, 1 for video, keep the default value for other types.", "default": 1, "title": "Cell Type" }, "description": "Video type, 1 for video, keep the default value for other types.", "example": 1 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:8856a75ae5d0eb2d3e6de5c34ded16aa5a519b835ba21f2988240d43ef39a72a" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/pipixia/app/fetch_increase_post_view_count?cell_id=7411193113223371043&cell_type=1' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-pipixia-app-fetch_increase_post_view_count" } }, "/apis/v1/tikhub/pipixia/app/fetch_post_comment_list": { "get": { "description": "Pipixia (app).\n\n### Purpose:\n- Get the comment list of a post.\n### Parameters:\n- cell_id: AKA video id, can be obtained from the share link.\n- cell_type: Video type, 1 for video, keep the default value for other types.\n- offset: Page cursor, default is 0, get the corresponding value from the `offset` Key in the previous page.\n### Return:\n- Post comment list\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_pipixia_app_fetch_post_comment_list", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Post comment list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "pipixia fetch_post_comment_list", "tags": [ "tikhub.pipixia" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "adb374081ce0" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/pipixia/app/fetch_post_comment_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_pipixia_app_fetch_post_comment_list", "method": "GET", "path": "/apis/v1/tikhub/pipixia/app/fetch_post_comment_list" }, "parameters": [ { "name": "cell_id", "in": "query", "required": true, "schema": { "type": "string", "description": "AKA video id, can be obtained from the share link.", "title": "Cell Id" }, "description": "AKA video id, can be obtained from the share link.", "example": "7411193113223371043" }, { "name": "cell_type", "in": "query", "required": false, "schema": { "type": "integer", "description": "Video type, 1 for video, keep the default value for other types.", "default": 1, "title": "Cell Type" }, "description": "Video type, 1 for video, keep the default value for other types.", "example": 1 }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "string", "description": "Page cursor, default is 0, get the corresponding value from the `offset` Key in the previous page.", "default": "0", "title": "Offset" }, "description": "Page cursor, default is 0, get the corresponding value from the `offset` Key in the previous page.", "example": "0" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:411c0f9b508e8765b64f168b43b130048d03129207992c4c7638705f975e2f71" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/pipixia/app/fetch_post_comment_list?cell_id=7411193113223371043&cell_type=1&offset=0' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-pipixia-app-fetch_post_comment_list" } }, "/apis/v1/tikhub/pipixia/app/fetch_post_detail": { "get": { "description": "Pipixia (app).\n\n### Purpose:\n- Get single video data, support photo, video, etc.\n### Parameters:\n- cell_id: AKA video id, can be obtained from the share link.\n- cell_type: Video type, 1 for video, keep the default value for other types.\n### Return:\n- Video data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_pipixia_app_fetch_post_detail", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Video data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "pipixia fetch_post_detail", "tags": [ "tikhub.pipixia" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "f337ff40483d" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/pipixia/app/fetch_post_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_pipixia_app_fetch_post_detail", "method": "GET", "path": "/apis/v1/tikhub/pipixia/app/fetch_post_detail" }, "parameters": [ { "name": "cell_id", "in": "query", "required": true, "schema": { "type": "string", "description": "AKA video id, can be obtained from the share link.", "title": "Cell Id" }, "description": "AKA video id, can be obtained from the share link.", "example": "7411193113223371043" }, { "name": "cell_type", "in": "query", "required": false, "schema": { "type": "integer", "description": "Video type, 1 for video, keep the default value for other types.", "default": 1, "title": "Cell Type" }, "description": "Video type, 1 for video, keep the default value for other types.", "example": 1 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:c04402c8a55acbd00de016a0fdd4bf0fce4aacc24a7df0b6cab25ecd943773ec" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/pipixia/app/fetch_post_detail?cell_id=7411193113223371043&cell_type=1' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-pipixia-app-fetch_post_detail" } }, "/apis/v1/tikhub/pipixia/app/fetch_post_statistics": { "get": { "description": "Pipixia (app).\n\n### Purpose:\n- Get the statistics of a single post, such as the number of likes, comments, reposts, etc.\n### Parameters:\n- cell_id: AKA video id, can be obtained from the share link.\n### Return:\n- Post statistics\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_pipixia_app_fetch_post_statistics", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Post statistics", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "pipixia fetch_post_statistics", "tags": [ "tikhub.pipixia" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "9a9906138320" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/pipixia/app/fetch_post_statistics", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_pipixia_app_fetch_post_statistics", "method": "GET", "path": "/apis/v1/tikhub/pipixia/app/fetch_post_statistics" }, "parameters": [ { "name": "cell_id", "in": "query", "required": true, "schema": { "type": "string", "description": "AKA video id, can be obtained from the share link.", "title": "Cell Id" }, "description": "AKA video id, can be obtained from the share link.", "example": "7411193113223371043" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:defeb37c46e282328530a29b0b7ead507fd0864f6b33686198bbcb8e27692aff" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/pipixia/app/fetch_post_statistics?cell_id=7411193113223371043' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-pipixia-app-fetch_post_statistics" } }, "/apis/v1/tikhub/pipixia/app/fetch_search": { "get": { "description": "Pipixia (app).\n\n### Purpose:\n- Search API, support search user, post, etc.\n### Parameters:\n- keyword: Search keyword.\n- offset: Page cursor, default is 0, get the corresponding value from the `offset` Key in the previous page.\n- search_type: Search type, available values are as follows:\n - 1: Comprehensive\n - 8: Hot\n - 9: Fresh\n - 2: Video\n - 3: Photo\n - 4: User\n - 5: Hashtag\n### Return:\n- Search result\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_pipixia_app_fetch_search", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Search result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "pipixia fetch_search", "tags": [ "tikhub.pipixia" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "3e528458249c" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/pipixia/app/fetch_search", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_pipixia_app_fetch_search", "method": "GET", "path": "/apis/v1/tikhub/pipixia/app/fetch_search" }, "parameters": [ { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Search keyword", "title": "Keyword" }, "description": "Search keyword", "example": "Pipixia" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "string", "description": "Page cursor, default is 0, get the corresponding value from the `offset` Key in the previous page.", "default": "0", "title": "Offset" }, "description": "Page cursor, default is 0, get the corresponding value from the `offset` Key in the previous page.", "example": "0" }, { "name": "search_type", "in": "query", "required": false, "schema": { "type": "string", "description": "Search type, available values are as follows:\n - 1: Comprehensive\n - 8: Hot\n - 9: Fresh\n - 2: Video\n - 3: Photo\n - 4: User\n - 5: Hashtag", "default": "1", "title": "Search Type" }, "description": "Search type, available values are as follows:\n - 1: Comprehensive\n - 8: Hot\n - 9: Fresh\n - 2: Video\n - 3: Photo\n - 4: User\n - 5: Hashtag", "example": "1" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:986cb3db7c135126ad536f0225b003bb003430c8c6a102bc1b0eca616a044b23" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/pipixia/app/fetch_search?keyword=Pipixia&offset=0&search_type=1' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-pipixia-app-fetch_search" } }, "/apis/v1/tikhub/pipixia/app/fetch_short_url": { "get": { "description": "Pipixia (app).\n\n### Purpose:\n- Generate short URL.\n### Parameters:\n- original_url: Original URL, can be any link.\n### Return:\n- Short URL\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_pipixia_app_fetch_short_url", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Short URL", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "pipixia fetch_short_url", "tags": [ "tikhub.pipixia" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "eafe5ce5ae68" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/pipixia/app/fetch_short_url", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_pipixia_app_fetch_short_url", "method": "GET", "path": "/apis/v1/tikhub/pipixia/app/fetch_short_url" }, "parameters": [ { "name": "original_url", "in": "query", "required": true, "schema": { "type": "string", "description": "Original URL", "title": "Original Url" }, "description": "Original URL", "example": "https://h5.pipix.com/item/7385813877985909043" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:2453d4407bed798594f9010caafe8b703ff1a57304f78a772a98dc6e3fcc00e3" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/pipixia/app/fetch_short_url?original_url=https%3A%2F%2Fh5.pipix.com%2Fitem%2F7385813877985909043' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-pipixia-app-fetch_short_url" } }, "/apis/v1/tikhub/pipixia/app/fetch_user_follower_list": { "get": { "description": "Pipixia (app).\n\n### Purpose:\n- Get user's follower list.\n### Parameters:\n- user_id: AKA user id, can be obtained from the share link.\n- cursor: Page cursor, default is 0, get the corresponding value from the `loadmore_cursor` Key in the previous page.\n### Return:\n- User follower list\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_pipixia_app_fetch_user_follower_list", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- User follower list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "pipixia fetch_user_follower_list", "tags": [ "tikhub.pipixia" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "7b7384effac4" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/pipixia/app/fetch_user_follower_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_pipixia_app_fetch_user_follower_list", "method": "GET", "path": "/apis/v1/tikhub/pipixia/app/fetch_user_follower_list" }, "parameters": [ { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "description": "Page cursor, default is 0, get the corresponding value from the `loadmore_cursor` Key in the previous page.", "default": "0", "title": "Cursor" }, "description": "Page cursor, default is 0, get the corresponding value from the `loadmore_cursor` Key in the previous page.", "example": "0" }, { "name": "user_id", "in": "query", "required": true, "schema": { "type": "string", "description": "AKA user id, can be obtained from the share link.", "title": "User Id" }, "description": "AKA user id, can be obtained from the share link.", "example": "1310254082831248" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:f2ce90bb8c88ac470f65f0a105c84393cd0bdd41420c0d310c3068df08606ab2" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/pipixia/app/fetch_user_follower_list?cursor=0&user_id=1310254082831248' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-pipixia-app-fetch_user_follower_list" } }, "/apis/v1/tikhub/pipixia/app/fetch_user_following_list": { "get": { "description": "Pipixia (app).\n\n### Purpose:\n- Get user's following list.\n### Parameters:\n- user_id: AKA user id, can be obtained from the share link.\n- cursor: Page cursor, default is 0, get the corresponding value from the `loadmore_cursor` Key in the previous page.\n### Return:\n- User following list\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_pipixia_app_fetch_user_following_list", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- User following list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "pipixia fetch_user_following_list", "tags": [ "tikhub.pipixia" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "7a7c91fafd2c" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/pipixia/app/fetch_user_following_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_pipixia_app_fetch_user_following_list", "method": "GET", "path": "/apis/v1/tikhub/pipixia/app/fetch_user_following_list" }, "parameters": [ { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "description": "Page cursor, default is 0, get the corresponding value from the `loadmore_cursor` Key in the previous page.", "default": "0", "title": "Cursor" }, "description": "Page cursor, default is 0, get the corresponding value from the `loadmore_cursor` Key in the previous page.", "example": "0" }, { "name": "user_id", "in": "query", "required": true, "schema": { "type": "string", "description": "AKA user id, can be obtained from the share link.", "title": "User Id" }, "description": "AKA user id, can be obtained from the share link.", "example": "1310254082831248" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e21b6cc870ad780c46fd26cc94c6ba6ead21b2a739d9bd4e31d26c3a8db1d2b2" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/pipixia/app/fetch_user_following_list?cursor=0&user_id=1310254082831248' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-pipixia-app-fetch_user_following_list" } }, "/apis/v1/tikhub/pipixia/app/fetch_user_info": { "get": { "description": "Pipixia (app).\n\n### Purpose:\n- Get user information, such as nickname and avatar.\n### Parameters:\n- user_id: AKA user id, can be obtained from the share link.\n### Return:\n- User information\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_pipixia_app_fetch_user_info", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- User information", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "pipixia fetch_user_info", "tags": [ "tikhub.pipixia" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "5be0dee60fd7" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/pipixia/app/fetch_user_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_pipixia_app_fetch_user_info", "method": "GET", "path": "/apis/v1/tikhub/pipixia/app/fetch_user_info" }, "parameters": [ { "name": "user_id", "in": "query", "required": true, "schema": { "type": "string", "description": "AKA user id, can be obtained from the share link.", "title": "User Id" }, "description": "AKA user id, can be obtained from the share link.", "example": "1020401" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:341539e411b93db6baa5bed99c92d549d02d8e735420963c120d407a371ff36a" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/pipixia/app/fetch_user_info?user_id=1020401' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-pipixia-app-fetch_user_info" } }, "/apis/v1/tikhub/pipixia/app/fetch_user_post_list": { "get": { "description": "Pipixia (app).\n\n### Purpose:\n- Get user post list, such as videos, photos, etc.\n### Parameters:\n- user_id: AKA user id, can be obtained from the share link.\n- cursor: Page cursor, default is 0, get the corresponding value from the `loadmore_cursor` Key in the previous page.\n- feed_count: Page count, default is 0, add 1 for each page, such as 0 for the first page, 1 for the second page, 2 for the third page, and so on.\n### Return:\n- User post list\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_pipixia_app_fetch_user_post_list", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- User post list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "pipixia fetch_user_post_list", "tags": [ "tikhub.pipixia" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "ec5b3edae994" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/pipixia/app/fetch_user_post_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_pipixia_app_fetch_user_post_list", "method": "GET", "path": "/apis/v1/tikhub/pipixia/app/fetch_user_post_list" }, "parameters": [ { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "description": "Page cursor, default is 0, get the corresponding value from the `loadmore_cursor` Key in the previous page.", "default": "0", "title": "Cursor" }, "description": "Page cursor, default is 0, get the corresponding value from the `loadmore_cursor` Key in the previous page.", "example": "0" }, { "name": "feed_count", "in": "query", "required": false, "schema": { "type": "string", "description": "Page count, default is 0, add 1 for each page, such as 0 for the first page, 1 for the second page, 2 for the third page, and so on.", "default": "0", "title": "Feed Count" }, "description": "Page count, default is 0, add 1 for each page, such as 0 for the first page, 1 for the second page, 2 for the third page, and so on.", "example": "0" }, { "name": "user_id", "in": "query", "required": true, "schema": { "type": "string", "description": "AKA user id, can be obtained from the share link.", "title": "User Id" }, "description": "AKA user id, can be obtained from the share link.", "example": "1310254082831248" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:2efce8dc477f3af88c01473382ba880d2402a40e2af83e62cde7c378bc5ad2f0" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/pipixia/app/fetch_user_post_list?cursor=0&feed_count=0&user_id=1310254082831248' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-pipixia-app-fetch_user_post_list" } }, "/apis/v1/tikhub/reddit/app/check_subreddit_muted": { "get": { "description": "Reddit (app).\n\n### Purpose:\n- Check if a specified Reddit subreddit is muted by the current user\n### Parameters:\n- subreddit_id: Subreddit ID starting with \"t5_\", can be obtained from fetch_subreddit_info endpoint\n### Returns:\n- JSON data of mute status containing:\n - isMuted: Boolean value indicating if muted\n - subredditId: Subreddit ID\n### Note:\n- **APP API ID format differs from Web API, requires type prefix**\n- Subreddit ID prefix: t5_ (e.g., t5_2qh0u)\n\nAPI references: `fetch_subreddit_info` = `GET /tikhub/reddit/app/fetch_subreddit_info` (operationId: `get_tikhub_reddit_app_fetch_subreddit_info`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_reddit_app_check_subreddit_muted", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- JSON data of mute status containing:\n - isMuted: Boolean value indicating if muted\n - subredditId: Subreddit ID", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "reddit check_subreddit_muted", "tags": [ "tikhub.reddit" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "22a5f2ea2635" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/reddit/app/check_subreddit_muted", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_reddit_app_check_subreddit_muted", "method": "GET", "path": "/apis/v1/tikhub/reddit/app/check_subreddit_muted" }, "parameters": [ { "name": "language", "in": "query", "required": false, "schema": { "type": "string", "minLength": 2, "maxLength": 16, "pattern": "^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$", "description": "Preferred response language as an IETF language tag; default: en-US", "default": "en-US", "title": "Language" }, "description": "Preferred response language as an IETF language tag; default: en-US" }, { "name": "need_format", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether to clean and format the data", "default": false, "title": "Need Format" }, "description": "Whether to clean and format the data", "example": false }, { "name": "subreddit_id", "in": "query", "required": true, "schema": { "type": "string", "minLength": 4, "maxLength": 20, "pattern": "^t5_[a-z0-9]{1,17}$", "description": "Subreddit ID starting with \"t5_\", can be obtained from fetch_subreddit_info endpoint\n\nAPI references: `fetch_subreddit_info` = `GET /tikhub/reddit/app/fetch_subreddit_info` (operationId: `get_tikhub_reddit_app_fetch_subreddit_info`).", "title": "Subreddit Id" }, "description": "Subreddit ID starting with \"t5_\", can be obtained from fetch_subreddit_info endpoint\n\nAPI references: `fetch_subreddit_info` = `GET /tikhub/reddit/app/fetch_subreddit_info` (operationId: `get_tikhub_reddit_app_fetch_subreddit_info`).", "example": "t5_2qh0u" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:56e31b8c5f738c3e41e01642b29fba0e7a8249c034a3bd9646b4a06c82128dff" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/reddit/app/check_subreddit_muted?need_format=false&subreddit_id=t5_2qh0u' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-reddit-app-check_subreddit_muted" } }, "/apis/v1/tikhub/reddit/app/fetch_comment_replies": { "get": { "description": "Reddit (app).\n\n### Purpose:\n- Fetch replies (sub-comments/second-level comments) under a specified Reddit APP comment\n- Use this endpoint when a comment node has more.cursor field to get its sub-comments\n### Parameters:\n- post_id: Post ID, format like \"t3_XXXXXX\"\n- cursor: Comment cursor from the more.cursor field in comment data, format like \"commenttree:ex:(xxx)\"\n- sort_type: Sort method, supports CONFIDENCE, NEW, TOP, HOT, CONTROVERSIAL, OLD, RANDOM\n### Returns:\n- JSON data of replies under the specified comment, containing:\n - List of sub-comments\n - Detailed information for each sub-comment (content, author, upvotes, etc.)\n - Pagination information\n### Usage Steps:\n1. First call fetch_post_comments to get top-level comments\n2. Find comment nodes with sub-comments (childCount > 0)\n3. Get the more.cursor value from that node\n4. Use that cursor to call this endpoint to fetch sub-comments\n### Note:\n- cursor value comes from the more.cursor field in comment data\n- Path example: $.data.postInfoById.commentForest.trees[*].more.cursor\n- cursor format example: \"commenttree:ex:(RjiJd\"\n\nAPI references: `fetch_post_comments` = `GET /tikhub/reddit/app/fetch_post_comments` (operationId: `get_tikhub_reddit_app_fetch_post_comments`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_reddit_app_fetch_comment_replies", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- JSON data of replies under the specified comment, containing:\n - List of sub-comments\n - Detailed information for each sub-comment (content, author, upvotes, etc.)\n - Pagination information", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "reddit fetch_comment_replies", "tags": [ "tikhub.reddit" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "1b5f2e3e876f" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/reddit/app/fetch_comment_replies", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_reddit_app_fetch_comment_replies", "method": "GET", "path": "/apis/v1/tikhub/reddit/app/fetch_comment_replies" }, "parameters": [ { "name": "cursor", "in": "query", "required": true, "schema": { "type": "string", "minLength": 13, "maxLength": 4096, "pattern": "^commenttree:", "description": "Comment cursor from the more.cursor field in comment data, format like \"commenttree:ex:(xxx)\" Obtain `more.cursor` from a comment node in `$.data.postInfoById.commentForest.trees[*]`. Call `GET /tikhub/reddit/app/fetch_post_comments` (operationId: `get_tikhub_reddit_app_fetch_post_comments`).", "title": "Cursor" }, "description": "Comment cursor from the more.cursor field in comment data, format like \"commenttree:ex:(xxx)\" Obtain `more.cursor` from a comment node in `$.data.postInfoById.commentForest.trees[*]`. Call `GET /tikhub/reddit/app/fetch_post_comments` (operationId: `get_tikhub_reddit_app_fetch_post_comments`).", "example": "commenttree:ex:(RjiJd" }, { "name": "language", "in": "query", "required": false, "schema": { "type": "string", "minLength": 2, "maxLength": 16, "pattern": "^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$", "description": "Preferred response language as an IETF language tag; default: en-US", "default": "en-US", "title": "Language" }, "description": "Preferred response language as an IETF language tag; default: en-US" }, { "name": "need_format", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether to clean and format the data", "default": false, "title": "Need Format" }, "description": "Whether to clean and format the data", "example": false }, { "name": "post_id", "in": "query", "required": true, "schema": { "type": "string", "minLength": 4, "maxLength": 20, "pattern": "^t3_[a-z0-9]{1,17}$", "description": "Post ID, format like \"t3_XXXXXX\"", "title": "Post Id" }, "description": "Post ID, format like \"t3_XXXXXX\"", "example": "t3_1qmup73" }, { "name": "sort_type", "in": "query", "required": false, "schema": { "enum": [ "CONFIDENCE", "NEW", "TOP", "HOT", "CONTROVERSIAL", "OLD", "RANDOM" ], "type": "string", "description": "Sort method: CONFIDENCE, NEW, TOP, HOT, CONTROVERSIAL, OLD, RANDOM", "default": "CONFIDENCE", "title": "Sort Type" }, "description": "Sort method: CONFIDENCE, NEW, TOP, HOT, CONTROVERSIAL, OLD, RANDOM", "example": "CONFIDENCE" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:143b51a3d987dec4ea660ba10d16989f2ee71b6eccc3cfee3328595997c701ed" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/reddit/app/fetch_comment_replies?cursor=commenttree%3Aex%3A%28RjiJd&need_format=false&post_id=t3_1qmup73&sort_type=CONFIDENCE' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-reddit-app-fetch_comment_replies" } }, "/apis/v1/tikhub/reddit/app/fetch_community_highlights": { "get": { "description": "Reddit (app).\n\n### Purpose:\n- Fetch featured highlight content of a specified Reddit APP community, including popular posts and important announcements\n### Parameters:\n- subreddit_id: Subreddit ID starting with \"t5_\", can be obtained from fetch_subreddit_info endpoint\n### Returns:\n- JSON data of community highlights containing:\n - Featured post list\n - Pinned announcements\n - Important community updates\n - Recommended content\n### Note:\n- **APP API ID format differs from Web API, requires type prefix**\n- Subreddit ID prefix: t5_ (e.g., t5_2qh0u)\n\nAPI references: `fetch_subreddit_info` = `GET /tikhub/reddit/app/fetch_subreddit_info` (operationId: `get_tikhub_reddit_app_fetch_subreddit_info`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_reddit_app_fetch_community_highlights", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- JSON data of community highlights containing:\n - Featured post list\n - Pinned announcements\n - Important community updates\n - Recommended content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "reddit fetch_community_highlights", "tags": [ "tikhub.reddit" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "19dcc4df6b21" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/reddit/app/fetch_community_highlights", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_reddit_app_fetch_community_highlights", "method": "GET", "path": "/apis/v1/tikhub/reddit/app/fetch_community_highlights" }, "parameters": [ { "name": "language", "in": "query", "required": false, "schema": { "type": "string", "minLength": 2, "maxLength": 16, "pattern": "^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$", "description": "Preferred response language as an IETF language tag; default: en-US", "default": "en-US", "title": "Language" }, "description": "Preferred response language as an IETF language tag; default: en-US" }, { "name": "need_format", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether to clean and format the data", "default": false, "title": "Need Format" }, "description": "Whether to clean and format the data", "example": false }, { "name": "subreddit_id", "in": "query", "required": true, "schema": { "type": "string", "minLength": 4, "maxLength": 20, "pattern": "^t5_[a-z0-9]{1,17}$", "description": "Subreddit ID starting with \"t5_\", can be obtained from fetch_subreddit_info endpoint\n\nAPI references: `fetch_subreddit_info` = `GET /tikhub/reddit/app/fetch_subreddit_info` (operationId: `get_tikhub_reddit_app_fetch_subreddit_info`).", "title": "Subreddit Id" }, "description": "Subreddit ID starting with \"t5_\", can be obtained from fetch_subreddit_info endpoint\n\nAPI references: `fetch_subreddit_info` = `GET /tikhub/reddit/app/fetch_subreddit_info` (operationId: `get_tikhub_reddit_app_fetch_subreddit_info`).", "example": "t5_2qh0u" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:1f9b49ec28d87d6d97a2ac56d92b55b359bc66a1282142b5875f47b42f21cf5a" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/reddit/app/fetch_community_highlights?need_format=false&subreddit_id=t5_2qh0u' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-reddit-app-fetch_community_highlights" } }, "/apis/v1/tikhub/reddit/app/fetch_dynamic_search": { "get": { "description": "Reddit (app).\n\n### Purpose:\n- Perform Reddit APP dynamic search, supporting posts, communities, comments, media, and users\n### Parameters:\n- query: Search keyword\n- search_type: Search type, options:\n - post: Search posts (default)\n - community: Search communities/subreddits\n - comment: Search comments\n - media: Search media (images/videos/GIFs)\n - people: Search users\n- sort: Sort method (only for post/comment/media types), options:\n - RELEVANCE: By relevance\n - HOT: Hot/trending\n - TOP: Most popular\n - NEW: Newest\n - COMMENTS: By comment count (only for post type)\n- time_range: Time range (only for post/media types), options:\n - all: All time\n - year: Past year\n - month: Past month\n - week: Past week\n - day: Today\n - hour: Past hour\n- safe_search: Safe search setting, \"unset\" or \"strict\"\n- allow_nsfw: Allow NSFW content, \"0\" or \"1\"\n- after: Pagination parameter for fetching next page\n### Returns:\n- JSON data of search results containing:\n - List of matching results (different data types based on search_type)\n - Pagination information\n### Notes:\n- community and people types do not support sort and time_range parameters\n- COMMENTS sort option only applies to post type\n- time_range parameter only applies to post and media types\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_reddit_app_fetch_dynamic_search", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- JSON data of search results containing:\n - List of matching results (different data types based on search_type)\n - Pagination information", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "reddit fetch_dynamic_search", "tags": [ "tikhub.reddit" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "8bc75a833316" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/reddit/app/fetch_dynamic_search", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_reddit_app_fetch_dynamic_search", "method": "GET", "path": "/apis/v1/tikhub/reddit/app/fetch_dynamic_search" }, "parameters": [ { "name": "after", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 4096, "description": "Pagination parameter", "default": "", "title": "After" }, "description": "Pagination parameter", "example": "" }, { "name": "allow_nsfw", "in": "query", "required": false, "schema": { "enum": [ "0", "1" ], "type": "string", "description": "Allow NSFW content: 0, 1", "default": "0", "title": "Allow Nsfw" }, "description": "Allow NSFW content: 0, 1", "example": "0" }, { "name": "language", "in": "query", "required": false, "schema": { "type": "string", "minLength": 2, "maxLength": 16, "pattern": "^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$", "description": "Preferred response language as an IETF language tag; default: en-US", "default": "en-US", "title": "Language" }, "description": "Preferred response language as an IETF language tag; default: en-US" }, { "name": "need_format", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether to clean and format the data", "default": false, "title": "Need Format" }, "description": "Whether to clean and format the data", "example": false }, { "name": "query", "in": "query", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 512, "description": "Search query", "title": "Query" }, "description": "Search query", "example": "python programming" }, { "name": "safe_search", "in": "query", "required": false, "schema": { "enum": [ "unset", "strict" ], "type": "string", "description": "Safe search setting: unset, strict", "default": "unset", "title": "Safe Search" }, "description": "Safe search setting: unset, strict", "example": "unset" }, { "name": "search_type", "in": "query", "required": false, "schema": { "enum": [ "post", "community", "comment", "media", "people" ], "type": "string", "description": "Search type, options:\n - post: Search posts (default)\n - community: Search communities/subreddits\n - comment: Search comments\n - media: Search media (images/videos/GIFs)\n - people: Search users", "default": "post", "title": "Search Type" }, "description": "Search type, options:\n - post: Search posts (default)\n - community: Search communities/subreddits\n - comment: Search comments\n - media: Search media (images/videos/GIFs)\n - people: Search users", "example": "post" }, { "name": "sort", "in": "query", "required": false, "schema": { "description": "Sort method (only for post/comment/media types), options:\n - RELEVANCE: By relevance\n - HOT: Hot/trending\n - TOP: Most popular\n - NEW: Newest\n - COMMENTS: By comment count (only for post type)", "title": "Sort", "enum": [ "RELEVANCE", "HOT", "TOP", "NEW", "COMMENTS", null ], "type": [ "string", "null" ] }, "description": "Sort method (only for post/comment/media types), options:\n - RELEVANCE: By relevance\n - HOT: Hot/trending\n - TOP: Most popular\n - NEW: Newest\n - COMMENTS: By comment count (only for post type)", "example": "RELEVANCE" }, { "name": "time_range", "in": "query", "required": false, "schema": { "description": "post/media)/Time range (only for post/media): all( ), year( ), month( ), week( ), day( ), hour( 1\n\nUsage: Time range (only for post/media types), options:\n - all: All time\n - year: Past year\n - month: Past month\n - week: Past week\n - day: Today\n - hour: Past hour", "title": "Time Range", "enum": [ "all", "year", "month", "week", "day", "hour", null ], "type": [ "string", "null" ] }, "description": "post/media)/Time range (only for post/media): all( ), year( ), month( ), week( ), day( ), hour( 1\n\nUsage: Time range (only for post/media types), options:\n - all: All time\n - year: Past year\n - month: Past month\n - week: Past week\n - day: Today\n - hour: Past hour", "example": "all" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:4d4107a698af46f0992fd4e5425c5bd27b20e43887a2fde3042722696a3ff8e8" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/reddit/app/fetch_dynamic_search?after=&allow_nsfw=0&need_format=false&query=python+programming&safe_search=unset&search_type=post&sort=RELEVANCE&time_range=all' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-reddit-app-fetch_dynamic_search" } }, "/apis/v1/tikhub/reddit/app/fetch_explore_feed": { "get": { "description": "Reddit (app).\n\n### Purpose\n- Fetch the Reddit APP Explore feed (Communities tab content) including:\n - Carousel community recommendations\n - Parent topic groups (TopicGroupFeedElement)\n - Taxonomy topics (TaxonomyTopicsFeedElement)\n- Also returns a flat `topics` list — pass each `id` to `/tikhub/reddit/app/fetch_topic_feed` to drill into a category.\n\n### Parameters\n- sort: Sort method, BEST (default) / HOT / NEW / TOP / CONTROVERSIAL\n- time: Time range, ALL (default) / HOUR / DAY / WEEK / MONTH / YEAR\n- need_format: Whether to clean the response\n\nAPI references: `fetch_topic_feed` = `GET /tikhub/reddit/app/fetch_topic_feed` (operationId: `get_tikhub_reddit_app_fetch_topic_feed`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_reddit_app_fetch_explore_feed", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "reddit fetch_explore_feed", "tags": [ "tikhub.reddit" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "c9e10b48765d" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/reddit/app/fetch_explore_feed", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_reddit_app_fetch_explore_feed", "method": "GET", "path": "/apis/v1/tikhub/reddit/app/fetch_explore_feed" }, "parameters": [ { "name": "language", "in": "query", "required": false, "schema": { "type": "string", "minLength": 2, "maxLength": 16, "pattern": "^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$", "description": "Preferred response language as an IETF language tag; default: en-US", "default": "en-US", "title": "Language" }, "description": "Preferred response language as an IETF language tag; default: en-US" }, { "name": "need_format", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether to clean and format the data", "default": false, "title": "Need Format" }, "description": "Whether to clean and format the data", "example": false }, { "name": "sort", "in": "query", "required": false, "schema": { "enum": [ "BEST", "HOT", "NEW", "TOP", "CONTROVERSIAL", "RISING" ], "type": "string", "description": "Sort method: BEST, HOT, NEW, TOP, CONTROVERSIAL", "default": "BEST", "title": "Sort" }, "description": "Sort method: BEST, HOT, NEW, TOP, CONTROVERSIAL", "example": "BEST" }, { "name": "time", "in": "query", "required": false, "schema": { "enum": [ "ALL", "HOUR", "DAY", "WEEK", "MONTH", "YEAR" ], "type": "string", "description": "Time range: ALL, HOUR, DAY, WEEK, MONTH, YEAR", "default": "ALL", "title": "Time" }, "description": "Time range: ALL, HOUR, DAY, WEEK, MONTH, YEAR", "example": "ALL" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:27bbbea9f88f276297f7b8a4eda303b4ba36d4554a0c305527dbe53091614a42" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-reddit-app-fetch_explore_feed" } }, "/apis/v1/tikhub/reddit/app/fetch_games_feed": { "get": { "description": "Reddit (app).\n\n### Purpose:\n- Fetch gaming-related recommended content on Reddit APP, displaying popular posts from gaming communities\n### Parameters:\n- sort: Sort method, options: NEW, HOT, TOP, RISING\n- time: Time range, options: ALL, HOUR, DAY, WEEK, MONTH, YEAR\n- after: Pagination parameter for fetching next page\n### Returns:\n- JSON data of games feed containing:\n - List of gaming-related posts\n - Gaming community discussions\n - Game news and updates\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_reddit_app_fetch_games_feed", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- JSON data of games feed containing:\n - List of gaming-related posts\n - Gaming community discussions\n - Game news and updates", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "reddit fetch_games_feed", "tags": [ "tikhub.reddit" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "d5cff46e511e" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/reddit/app/fetch_games_feed", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_reddit_app_fetch_games_feed", "method": "GET", "path": "/apis/v1/tikhub/reddit/app/fetch_games_feed" }, "parameters": [ { "name": "after", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 4096, "description": "Pagination parameter", "default": "", "title": "After" }, "description": "Pagination parameter", "example": "" }, { "name": "language", "in": "query", "required": false, "schema": { "type": "string", "minLength": 2, "maxLength": 16, "pattern": "^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$", "description": "Preferred response language as an IETF language tag; default: en-US", "default": "en-US", "title": "Language" }, "description": "Preferred response language as an IETF language tag; default: en-US" }, { "name": "need_format", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether to clean and format the data", "default": false, "title": "Need Format" }, "description": "Whether to clean and format the data", "example": false }, { "name": "sort", "in": "query", "required": false, "schema": { "enum": [ "BEST", "HOT", "NEW", "TOP", "CONTROVERSIAL", "RISING" ], "type": "string", "description": "Sort method: NEW, HOT, TOP, RISING", "default": "NEW", "title": "Sort" }, "description": "Sort method: NEW, HOT, TOP, RISING", "example": "HOT" }, { "name": "time", "in": "query", "required": false, "schema": { "enum": [ "ALL", "HOUR", "DAY", "WEEK", "MONTH", "YEAR" ], "type": "string", "description": "Time range: ALL, HOUR, DAY, WEEK, MONTH, YEAR", "default": "ALL", "title": "Time" }, "description": "Time range: ALL, HOUR, DAY, WEEK, MONTH, YEAR", "example": "WEEK" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:59403c50de671c8a5ca84312670637b882899a3684b3387b868aa35f24756136" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-reddit-app-fetch_games_feed" } }, "/apis/v1/tikhub/reddit/app/fetch_generated_comments": { "get": { "description": "Reddit (app).\n\n### Purpose:\n- Fetch lightweight comment info used by Reddit Answers \"Generated for you\" cards\n- Returns: id / createdAt / score / authorInfo / postInfo / permalink\n### Parameters:\n- comment_ids: Comment IDs comma-separated, e.g. \"t1_XXXXXX,t1_YYYYYY\", max 30\n- need_format: Whether to clean and format the data\n### Note:\n- **APP API ID format differs from Web API, requires type prefix**\n- Comment ID prefix: t1_\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_reddit_app_fetch_generated_comments", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "reddit fetch_generated_comments", "tags": [ "tikhub.reddit" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "711c2addcc71" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/reddit/app/fetch_generated_comments", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_reddit_app_fetch_generated_comments", "method": "GET", "path": "/apis/v1/tikhub/reddit/app/fetch_generated_comments" }, "parameters": [ { "name": "comment_ids", "in": "query", "required": true, "schema": { "type": "string", "minLength": 4, "maxLength": 629, "pattern": "^t1_[a-z0-9]{1,17}(?:\\s*,\\s*t1_[a-z0-9]{1,17})*$", "description": "Comment IDs comma-separated, max 30", "title": "Comment Ids" }, "description": "Comment IDs comma-separated, max 30", "example": "t1_onfhplx,t1_onfk44g,t1_onfmbu3" }, { "name": "language", "in": "query", "required": false, "schema": { "type": "string", "minLength": 2, "maxLength": 16, "pattern": "^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$", "description": "Preferred response language as an IETF language tag; default: en-US", "default": "en-US", "title": "Language" }, "description": "Preferred response language as an IETF language tag; default: en-US" }, { "name": "need_format", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether to clean and format the data", "default": false, "title": "Need Format" }, "description": "Whether to clean and format the data", "example": false } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:27bbbea9f88f276297f7b8a4eda303b4ba36d4554a0c305527dbe53091614a42" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/reddit/app/fetch_generated_comments?comment_ids=t1_onfhplx%2Ct1_onfk44g%2Ct1_onfmbu3&need_format=false' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-reddit-app-fetch_generated_comments" } }, "/apis/v1/tikhub/reddit/app/fetch_generated_posts": { "get": { "description": "Reddit (app).\n\n### Purpose:\n- Fetch lightweight post info used by the Reddit Answers \"Generated for you\" cards\n- More concise than fetch_post_details_batch, only includes id / title / score /\n commentCount / createdAt / url / authorInfo / subreddit / media\n### Parameters:\n- post_ids: Post IDs comma-separated, e.g. \"t3_XXXXXX,t3_YYYYYY\", max 30\n- need_format: Whether to clean and format the data\n### Note:\n- **APP API ID format differs from Web API, requires type prefix**\n- Post ID prefix: t3_\n\nAPI references: `fetch_post_details_batch` = `GET /tikhub/reddit/app/fetch_post_details_batch` (operationId: `get_tikhub_reddit_app_fetch_post_details_batch`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_reddit_app_fetch_generated_posts", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "reddit fetch_generated_posts", "tags": [ "tikhub.reddit" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "235d6dbb932b" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/reddit/app/fetch_generated_posts", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_reddit_app_fetch_generated_posts", "method": "GET", "path": "/apis/v1/tikhub/reddit/app/fetch_generated_posts" }, "parameters": [ { "name": "language", "in": "query", "required": false, "schema": { "type": "string", "minLength": 2, "maxLength": 16, "pattern": "^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$", "description": "Preferred response language as an IETF language tag; default: en-US", "default": "en-US", "title": "Language" }, "description": "Preferred response language as an IETF language tag; default: en-US" }, { "name": "need_format", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether to clean and format the data", "default": false, "title": "Need Format" }, "description": "Whether to clean and format the data", "example": false }, { "name": "post_ids", "in": "query", "required": true, "schema": { "type": "string", "minLength": 4, "maxLength": 629, "pattern": "^t3_[a-z0-9]{1,17}(?:\\s*,\\s*t3_[a-z0-9]{1,17})*$", "description": "Post IDs comma-separated, max 30", "title": "Post Ids" }, "description": "Post IDs comma-separated, max 30", "example": "t3_1tlh0ir,t3_1tl1dlj,t3_1tl0br7" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:27bbbea9f88f276297f7b8a4eda303b4ba36d4554a0c305527dbe53091614a42" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/reddit/app/fetch_generated_posts?need_format=false&post_ids=t3_1tlh0ir%2Ct3_1tl1dlj%2Ct3_1tl0br7' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-reddit-app-fetch_generated_posts" } }, "/apis/v1/tikhub/reddit/app/fetch_home_feed": { "get": { "description": "Reddit (app).\n\n### Purpose:\n- Fetch Reddit APP home feed content\n### Parameters:\n- sort: Sort method, supports HOT, NEW, TOP, BEST, CONTROVERSIAL\n- filter_posts: List of post IDs to filter out, used to exclude already fetched posts\n- after: Pagination parameter for fetching the next page\n### Returns:\n- JSON data of Reddit APP home feed content\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_reddit_app_fetch_home_feed", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- JSON data of Reddit APP home feed content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "reddit fetch_home_feed", "tags": [ "tikhub.reddit" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "ae4eb11bc7d0" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/reddit/app/fetch_home_feed", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_reddit_app_fetch_home_feed", "method": "GET", "path": "/apis/v1/tikhub/reddit/app/fetch_home_feed" }, "parameters": [ { "name": "after", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 4096, "description": "Pagination parameter for fetching next page", "default": "", "title": "After" }, "description": "Pagination parameter for fetching next page", "example": "dDNfMW9qNXgyYg==" }, { "name": "filter_posts", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string", "minLength": 4, "maxLength": 20, "pattern": "^t3_[a-z0-9]+$" }, "maxItems": 100, "description": "Filter out specified post IDs\n\nUsage: List of post IDs to filter out, used to exclude already fetched posts", "default": [], "title": "Filter Posts" }, "description": "Filter out specified post IDs\n\nUsage: List of post IDs to filter out, used to exclude already fetched posts", "example": [ "t3_1ojjquz", "t3_1ohepm2", "t3_1ojxzzz", "t3_1ojnvca", "t3_1oj9dcb", "t3_1ojxubp", "t3_1oj5x2b" ] }, { "name": "language", "in": "query", "required": false, "schema": { "type": "string", "minLength": 2, "maxLength": 16, "pattern": "^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$", "description": "Preferred response language as an IETF language tag; default: en-US", "default": "en-US", "title": "Language" }, "description": "Preferred response language as an IETF language tag; default: en-US" }, { "name": "need_format", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether to clean and format the data", "default": false, "title": "Need Format" }, "description": "Whether to clean and format the data", "example": false }, { "name": "sort", "in": "query", "required": false, "schema": { "enum": [ "BEST", "HOT", "NEW", "TOP", "CONTROVERSIAL", "RISING" ], "type": "string", "description": "Sort method: HOT, NEW, TOP, BEST, CONTROVERSIAL", "default": "BEST", "title": "Sort" }, "description": "Sort method: HOT, NEW, TOP, BEST, CONTROVERSIAL", "example": "BEST" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:887e05b8f12ba6261bda174feb12122dda28cf21795f5a13fad35b7c38a58fc6" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-reddit-app-fetch_home_feed" } }, "/apis/v1/tikhub/reddit/app/fetch_news_feed": { "get": { "description": "Reddit (app).\n\n### Purpose:\n- Fetch news-related recommended content on Reddit APP, displaying latest news and current affairs discussions\n### Parameters:\n- subtopic_ids: List of subtopic IDs, default [\"all\"] means all news categories\n- after: Pagination parameter for fetching next page\n### Returns:\n- JSON data of news feed containing:\n - List of news posts\n - Current affairs discussions\n - Trending topics\n - News sources and links\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_reddit_app_fetch_news_feed", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- JSON data of news feed containing:\n - List of news posts\n - Current affairs discussions\n - Trending topics\n - News sources and links", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "reddit fetch_news_feed", "tags": [ "tikhub.reddit" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "6e66375d7480" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/reddit/app/fetch_news_feed", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_reddit_app_fetch_news_feed", "method": "GET", "path": "/apis/v1/tikhub/reddit/app/fetch_news_feed" }, "parameters": [ { "name": "after", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 4096, "description": "Pagination parameter", "default": "", "title": "After" }, "description": "Pagination parameter", "example": "" }, { "name": "language", "in": "query", "required": false, "schema": { "type": "string", "minLength": 2, "maxLength": 16, "pattern": "^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$", "description": "Preferred response language as an IETF language tag; default: en-US", "default": "en-US", "title": "Language" }, "description": "Preferred response language as an IETF language tag; default: en-US" }, { "name": "need_format", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether to clean and format the data", "default": false, "title": "Need Format" }, "description": "Whether to clean and format the data", "example": false }, { "name": "subtopic_ids", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 64, "pattern": "^[A-Za-z0-9_-]+$" }, "maxItems": 50, "description": "List of subtopic IDs, default [\"all\"] means all news categories", "default": [ "all" ], "title": "Subtopic Ids" }, "description": "List of subtopic IDs, default [\"all\"] means all news categories", "example": [ "all" ] } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:812009c4c28a01829cf93ddb81b4d92b1e4b90fccee3fe439d04e93fac6587da" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-reddit-app-fetch_news_feed" } }, "/apis/v1/tikhub/reddit/app/fetch_popular_feed": { "get": { "description": "Reddit (app).\n\n### Purpose:\n- Fetch popular/trending recommended content on Reddit APP, displaying the most popular posts site-wide\n### Parameters:\n- sort: Sort method, options: BEST, HOT, NEW, TOP, CONTROVERSIAL, RISING\n- time: Time range, options: ALL, HOUR, DAY, WEEK, MONTH, YEAR\n- filter_posts: List of post IDs to filter out, used to avoid duplicate fetches\n- after: Pagination parameter for fetching next page\n### Returns:\n- JSON data of popular feed containing:\n - List of trending posts\n - Detailed post information (title, content, upvotes, comments, etc.)\n - Pagination information (after parameter for next page)\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_reddit_app_fetch_popular_feed", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- JSON data of popular feed containing:\n - List of trending posts\n - Detailed post information (title, content, upvotes, comments, etc.)\n - Pagination information (after parameter for next page)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "reddit fetch_popular_feed", "tags": [ "tikhub.reddit" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "126f84eec8fa" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/reddit/app/fetch_popular_feed", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_reddit_app_fetch_popular_feed", "method": "GET", "path": "/apis/v1/tikhub/reddit/app/fetch_popular_feed" }, "parameters": [ { "name": "after", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 4096, "description": "Pagination parameter", "default": "", "title": "After" }, "description": "Pagination parameter", "example": "" }, { "name": "filter_posts", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string", "minLength": 4, "maxLength": 20, "pattern": "^t3_[a-z0-9]+$" }, "maxItems": 100, "description": "List of post IDs to filter out, used to avoid duplicate fetches", "default": [], "title": "Filter Posts" }, "description": "List of post IDs to filter out, used to avoid duplicate fetches", "example": [] }, { "name": "language", "in": "query", "required": false, "schema": { "type": "string", "minLength": 2, "maxLength": 16, "pattern": "^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$", "description": "Preferred response language as an IETF language tag; default: en-US", "default": "en-US", "title": "Language" }, "description": "Preferred response language as an IETF language tag; default: en-US" }, { "name": "need_format", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether to clean and format the data", "default": false, "title": "Need Format" }, "description": "Whether to clean and format the data", "example": false }, { "name": "sort", "in": "query", "required": false, "schema": { "enum": [ "BEST", "HOT", "NEW", "TOP", "CONTROVERSIAL", "RISING" ], "type": "string", "description": "Sort method: BEST, HOT, NEW, TOP, CONTROVERSIAL, RISING", "default": "BEST", "title": "Sort" }, "description": "Sort method: BEST, HOT, NEW, TOP, CONTROVERSIAL, RISING", "example": "HOT" }, { "name": "time", "in": "query", "required": false, "schema": { "enum": [ "ALL", "HOUR", "DAY", "WEEK", "MONTH", "YEAR" ], "type": "string", "description": "Time range: ALL, HOUR, DAY, WEEK, MONTH, YEAR", "default": "ALL", "title": "Time" }, "description": "Time range: ALL, HOUR, DAY, WEEK, MONTH, YEAR", "example": "DAY" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:633adbd619eb07e9ef4c47fdb4119e9ecbe1e66275148414d85d7d3b496eda05" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-reddit-app-fetch_popular_feed" } }, "/apis/v1/tikhub/reddit/app/fetch_post_comments": { "get": { "description": "Reddit (app).\n\n### Purpose:\n- Fetch comments under a specified Reddit APP post\n### Parameters:\n- post_id: Post ID, format like \"t3_XXXXXX\"\n- sort_type: Sort method, supports HOT, NEW, TOP, BEST, CONTROVERSIAL\n- after: Pagination parameter for fetching the next page, can be found in the last comment node in commentForest, e.g., $.data.postInfoById.commentForest.trees[-1].more.cursor\n### Returns:\n- JSON data of comments under the specified post\n### Note:\n- **APP API ID format differs from Web API, requires type prefix**\n- Post ID prefix: t3_ (e.g., t3_1ojnvca)\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_reddit_app_fetch_post_comments", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- JSON data of comments under the specified post", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "reddit fetch_post_comments", "tags": [ "tikhub.reddit" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "d3e05ee9eda3" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/reddit/app/fetch_post_comments", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_reddit_app_fetch_post_comments", "method": "GET", "path": "/apis/v1/tikhub/reddit/app/fetch_post_comments" }, "parameters": [ { "name": "after", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 4096, "description": "Pagination parameter for fetching the next page, can be found in the last comment node in commentForest, e.g., $.data.postInfoById.commentForest.trees[-1].more.cursor", "default": "", "title": "After" }, "description": "Pagination parameter for fetching the next page, can be found in the last comment node in commentForest, e.g., $.data.postInfoById.commentForest.trees[-1].more.cursor", "example": "" }, { "name": "language", "in": "query", "required": false, "schema": { "type": "string", "minLength": 2, "maxLength": 16, "pattern": "^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$", "description": "Preferred response language as an IETF language tag; default: en-US", "default": "en-US", "title": "Language" }, "description": "Preferred response language as an IETF language tag; default: en-US" }, { "name": "need_format", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether to clean and format the data", "default": false, "title": "Need Format" }, "description": "Whether to clean and format the data", "example": false }, { "name": "post_id", "in": "query", "required": true, "schema": { "type": "string", "minLength": 4, "maxLength": 20, "pattern": "^t3_[a-z0-9]{1,17}$", "description": "Post ID, format like \"t3_XXXXXX\"", "title": "Post Id" }, "description": "Post ID, format like \"t3_XXXXXX\"", "example": "t3_1ojnvca" }, { "name": "sort_type", "in": "query", "required": false, "schema": { "enum": [ "CONFIDENCE", "NEW", "TOP", "HOT", "CONTROVERSIAL", "OLD", "RANDOM" ], "type": "string", "description": "Sort method: CONFIDENCE, NEW, TOP, HOT, CONTROVERSIAL, OLD, RANDOM", "default": "CONFIDENCE", "title": "Sort Type" }, "description": "Sort method: CONFIDENCE, NEW, TOP, HOT, CONTROVERSIAL, OLD, RANDOM", "example": "CONFIDENCE" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e4aac9ab7ef740b2e8d97fedc625c0214c7b47a86f075126415f21b8a6db4775" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/reddit/app/fetch_post_comments?after=&need_format=false&post_id=t3_1ojnvca&sort_type=CONFIDENCE' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-reddit-app-fetch_post_comments" } }, "/apis/v1/tikhub/reddit/app/fetch_post_details": { "get": { "description": "Reddit (app).\n\n## Purpose:\n- Fetch single post details by post ID\n- Optionally include context for specific comments\n\n## Parameters:\n- post_id: Post ID, format like \"t3_XXXXXX\"\n- include_comment_id: Whether to include specific comment ID, default False\n- comment_id: Comment ID (used when include_comment_id is True), format like \"t1_XXXXXX\"\n\n## Returns:\n- Data containing detailed post information including:\n - Post content, title, author\n - Statistics (upvotes, comment count, etc.)\n - Subreddit information\n - Award information\n - Media resources\n - Recommendation reasons, etc.\n\n## Note:\n- **APP API ID format differs from Web API, requires type prefix**\n- Post ID prefix: t3_ (e.g., t3_1ojnh50)\n- Comment ID prefix: t1_ (e.g., t1_abcd123)\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_reddit_app_fetch_post_details", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- Data containing detailed post information including:\n - Post content, title, author\n - Statistics (upvotes, comment count, etc.)\n - Subreddit information\n - Award information\n - Media resources\n - Recommendation reasons, etc.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "reddit fetch_post_details", "tags": [ "tikhub.reddit" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "7e21cb33c748" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/reddit/app/fetch_post_details", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_reddit_app_fetch_post_details", "method": "GET", "path": "/apis/v1/tikhub/reddit/app/fetch_post_details" }, "parameters": [ { "name": "comment_id", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 20, "pattern": "^(?:|t1_[a-z0-9]{1,17})$", "description": "Comment ID (when include_comment_id is True", "default": "", "title": "Comment Id" }, "description": "Comment ID (when include_comment_id is True", "example": "" }, { "name": "include_comment_id", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Include specific comment ID", "default": false, "title": "Include Comment Id" }, "description": "Include specific comment ID", "example": false }, { "name": "language", "in": "query", "required": false, "schema": { "type": "string", "minLength": 2, "maxLength": 16, "pattern": "^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$", "description": "Preferred response language as an IETF language tag; default: en-US", "default": "en-US", "title": "Language" }, "description": "Preferred response language as an IETF language tag; default: en-US" }, { "name": "need_format", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether to clean and format the data", "default": false, "title": "Need Format" }, "description": "Whether to clean and format the data", "example": false }, { "name": "post_id", "in": "query", "required": true, "schema": { "type": "string", "minLength": 4, "maxLength": 20, "pattern": "^t3_[a-z0-9]{1,17}$", "description": "Post ID, format like \"t3_XXXXXX\"", "title": "Post Id" }, "description": "Post ID, format like \"t3_XXXXXX\"", "example": "t3_1ojnh50" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:deb9b7bcb19baa80359b54220567f357070e95ec88a115a95c0e458a05612ab2" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/reddit/app/fetch_post_details?comment_id=&include_comment_id=false&need_format=false&post_id=t3_1ojnh50' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-reddit-app-fetch_post_details" } }, "/apis/v1/tikhub/reddit/app/fetch_post_details_batch": { "get": { "description": "Reddit (app).\n\n## Purpose:\n- Fetch post details in batch by post ID list\n- Support batch query for up to 5 posts\n- Optionally include context for specific comments\n\n## Parameters:\n- post_ids: Post IDs comma-separated, format like \"t3_XXXXXX,t3_YYYYYY\", max 5 posts\n- include_comment_id: Whether to include specific comment ID, default False\n- comment_id: Comment ID (used when include_comment_id is True), format like \"t1_XXXXXX\"\n\n## Returns:\n- Data containing detailed post information including:\n - Post content, title, author\n - Statistics (upvotes, comment count, etc.)\n - Subreddit information\n - Award information\n - Media resources\n - Recommendation reasons, etc.\n\n## Notes:\n- Maximum 5 posts per batch query\n- Error will be returned if exceeds 5 posts\n- **APP API ID format differs from Web API, requires type prefix**\n- Post ID prefix: t3_ (e.g., t3_1ojnh50)\n- Comment ID prefix: t1_ (e.g., t1_abcd123)\n\n\nPublished reference price: $0.005 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_reddit_app_fetch_post_details_batch", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- Data containing detailed post information including:\n - Post content, title, author\n - Statistics (upvotes, comment count, etc.)\n - Subreddit information\n - Award information\n - Media resources\n - Recommendation reasons, etc.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "reddit fetch_post_details_batch", "tags": [ "tikhub.reddit" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.005, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "3577ee5ca36b" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/reddit/app/fetch_post_details_batch", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_reddit_app_fetch_post_details_batch", "method": "GET", "path": "/apis/v1/tikhub/reddit/app/fetch_post_details_batch" }, "parameters": [ { "name": "comment_id", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 20, "pattern": "^(?:|t1_[a-z0-9]{1,17})$", "description": "Comment ID (when include_comment_id is True", "default": "", "title": "Comment Id" }, "description": "Comment ID (when include_comment_id is True", "example": "" }, { "name": "include_comment_id", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Include specific comment ID", "default": false, "title": "Include Comment Id" }, "description": "Include specific comment ID", "example": false }, { "name": "language", "in": "query", "required": false, "schema": { "type": "string", "minLength": 2, "maxLength": 16, "pattern": "^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$", "description": "Preferred response language as an IETF language tag; default: en-US", "default": "en-US", "title": "Language" }, "description": "Preferred response language as an IETF language tag; default: en-US" }, { "name": "need_format", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether to clean and format the data", "default": false, "title": "Need Format" }, "description": "Whether to clean and format the data", "example": false }, { "name": "post_ids", "in": "query", "required": true, "schema": { "type": "string", "minLength": 4, "maxLength": 104, "pattern": "^t3_[a-z0-9]{1,17}(?:\\s*,\\s*t3_[a-z0-9]{1,17})*$", "description": "Post IDs comma-separated, format like \"t3_XXXXXX,t3_YYYYYY\", max 5 posts", "title": "Post Ids" }, "description": "Post IDs comma-separated, format like \"t3_XXXXXX,t3_YYYYYY\", max 5 posts", "example": "t3_1ojnh50,t3_1ok432f,t3_1nwil8j" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:deb9b7bcb19baa80359b54220567f357070e95ec88a115a95c0e458a05612ab2" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/reddit/app/fetch_post_details_batch?comment_id=&include_comment_id=false&need_format=false&post_ids=t3_1ojnh50%2Ct3_1ok432f%2Ct3_1nwil8j' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-reddit-app-fetch_post_details_batch" } }, "/apis/v1/tikhub/reddit/app/fetch_post_details_batch_large": { "get": { "description": "Reddit (app).\n\n## Purpose:\n- Fetch post details in large batch by post ID list\n- Support batch query for up to 30 posts\n- Optionally include context for specific comments\n\n## Parameters:\n- post_ids: Post IDs comma-separated, format like \"t3_XXXXXX,t3_YYYYYY,...\", max 30 posts\n- include_comment_id: Whether to include specific comment ID, default False\n- comment_id: Comment ID (used when include_comment_id is True), format like \"t1_XXXXXX\"\n\n## Returns:\n- Data containing detailed post information including:\n - Post content, title, author\n - Statistics (upvotes, comment count, etc.)\n - Subreddit information\n - Award information\n - Media resources\n - Recommendation reasons, etc.\n\n## Notes:\n- Maximum 30 posts per batch query\n- Error will be returned if exceeds 30 posts\n- Large batch queries may take longer to respond\n- **APP API ID format differs from Web API, requires type prefix**\n- Post ID prefix: t3_ (e.g., t3_1ojnh50)\n- Comment ID prefix: t1_ (e.g., t1_abcd123)\n\n\nPublished reference price: $0.025 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_reddit_app_fetch_post_details_batch_large", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- Data containing detailed post information including:\n - Post content, title, author\n - Statistics (upvotes, comment count, etc.)\n - Subreddit information\n - Award information\n - Media resources\n - Recommendation reasons, etc.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "reddit fetch_post_details_batch_large", "tags": [ "tikhub.reddit" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.025, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "dc875d128cab" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/reddit/app/fetch_post_details_batch_large", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_reddit_app_fetch_post_details_batch_large", "method": "GET", "path": "/apis/v1/tikhub/reddit/app/fetch_post_details_batch_large" }, "parameters": [ { "name": "comment_id", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 20, "pattern": "^(?:|t1_[a-z0-9]{1,17})$", "description": "Comment ID (when include_comment_id is True", "default": "", "title": "Comment Id" }, "description": "Comment ID (when include_comment_id is True", "example": "" }, { "name": "include_comment_id", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Include specific comment ID", "default": false, "title": "Include Comment Id" }, "description": "Include specific comment ID", "example": false }, { "name": "language", "in": "query", "required": false, "schema": { "type": "string", "minLength": 2, "maxLength": 16, "pattern": "^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$", "description": "Preferred response language as an IETF language tag; default: en-US", "default": "en-US", "title": "Language" }, "description": "Preferred response language as an IETF language tag; default: en-US" }, { "name": "need_format", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether to clean and format the data", "default": false, "title": "Need Format" }, "description": "Whether to clean and format the data", "example": false }, { "name": "post_ids", "in": "query", "required": true, "schema": { "type": "string", "minLength": 4, "maxLength": 629, "pattern": "^t3_[a-z0-9]{1,17}(?:\\s*,\\s*t3_[a-z0-9]{1,17})*$", "description": "Post IDs comma-separated, format like \"t3_XXXXXX,t3_YYYYYY,...\", max 30 posts", "title": "Post Ids" }, "description": "Post IDs comma-separated, format like \"t3_XXXXXX,t3_YYYYYY,...\", max 30 posts", "example": "t3_1ojnh50,t3_1ok432f,t3_1nwil8j,t3_1oj6vn6,t3_1nuenmd" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:deb9b7bcb19baa80359b54220567f357070e95ec88a115a95c0e458a05612ab2" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/reddit/app/fetch_post_details_batch_large?comment_id=&include_comment_id=false&need_format=false&post_ids=t3_1ojnh50%2Ct3_1ok432f%2Ct3_1nwil8j%2Ct3_1oj6vn6%2Ct3_1nuenmd' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-reddit-app-fetch_post_details_batch_large" } }, "/apis/v1/tikhub/reddit/app/fetch_search_typeahead": { "get": { "description": "Reddit (app).\n\n### Purpose:\n- Fetch autocomplete suggestions for the Reddit APP search box, including recommended subreddits, users, and search terms\n### Parameters:\n- query: Search keyword, the search text being typed\n- safe_search: Safe search setting, options are \"unset\" or \"strict\"\n- allow_nsfw: Whether to allow NSFW (adult) content display, \"0\" means disallow, \"1\" means allow\n### Returns:\n- JSON data of search suggestions containing the following types:\n - Related subreddits\n - Related users\n - Search term suggestions\n - Trending topics\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_reddit_app_fetch_search_typeahead", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- JSON data of search suggestions containing the following types:\n - Related subreddits\n - Related users\n - Search term suggestions\n - Trending topics", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "reddit fetch_search_typeahead", "tags": [ "tikhub.reddit" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a14930fc0490" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/reddit/app/fetch_search_typeahead", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_reddit_app_fetch_search_typeahead", "method": "GET", "path": "/apis/v1/tikhub/reddit/app/fetch_search_typeahead" }, "parameters": [ { "name": "allow_nsfw", "in": "query", "required": false, "schema": { "enum": [ "0", "1" ], "type": "string", "description": "Whether to allow NSFW (adult) content display, \"0\" means disallow, \"1\" means allow", "default": "0", "title": "Allow Nsfw" }, "description": "Whether to allow NSFW (adult) content display, \"0\" means disallow, \"1\" means allow", "example": "0" }, { "name": "language", "in": "query", "required": false, "schema": { "type": "string", "minLength": 2, "maxLength": 16, "pattern": "^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$", "description": "Preferred response language as an IETF language tag; default: en-US", "default": "en-US", "title": "Language" }, "description": "Preferred response language as an IETF language tag; default: en-US" }, { "name": "need_format", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether to clean and format the data", "default": false, "title": "Need Format" }, "description": "Whether to clean and format the data", "example": false }, { "name": "query", "in": "query", "required": true, "schema": { "type": "string", "maxLength": 512, "description": "Search query\n\nUsage: Search keyword, the search text being typed", "title": "Query" }, "description": "Search query\n\nUsage: Search keyword, the search text being typed", "example": "programming" }, { "name": "safe_search", "in": "query", "required": false, "schema": { "enum": [ "unset", "strict" ], "type": "string", "description": "Safe search setting: unset, strict", "default": "unset", "title": "Safe Search" }, "description": "Safe search setting: unset, strict", "example": "unset" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:ff9c292f9ec7b46e0f273c42da9efc38915b6d6c4939ea39a6770b99874c236e" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/reddit/app/fetch_search_typeahead?allow_nsfw=0&need_format=false&query=programming&safe_search=unset' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-reddit-app-fetch_search_typeahead" } }, "/apis/v1/tikhub/reddit/app/fetch_subreddit_feed": { "get": { "description": "Reddit (app).\n\n### Purpose:\n- Fetch feed content stream of a specified Reddit subreddit, displaying the post list of that subreddit\n### Parameters:\n- subreddit_name: Subreddit name (without r/ prefix), e.g., \"pics\", \"funny\"\n- sort: Sort method, options: BEST, HOT, NEW, TOP, CONTROVERSIAL, RISING\n- filter_posts: List of post IDs to filter out\n- after: Pagination parameter for fetching next page\n### Returns:\n- JSON data of subreddit feed containing:\n - List of posts in the subreddit\n - Detailed post information\n - Subreddit metadata\n - Pagination information\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_reddit_app_fetch_subreddit_feed", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- JSON data of subreddit feed containing:\n - List of posts in the subreddit\n - Detailed post information\n - Subreddit metadata\n - Pagination information", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "reddit fetch_subreddit_feed", "tags": [ "tikhub.reddit" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "3bd002206135" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/reddit/app/fetch_subreddit_feed", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_reddit_app_fetch_subreddit_feed", "method": "GET", "path": "/apis/v1/tikhub/reddit/app/fetch_subreddit_feed" }, "parameters": [ { "name": "after", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 4096, "description": "Pagination parameter", "default": "", "title": "After" }, "description": "Pagination parameter", "example": "" }, { "name": "filter_posts", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string", "minLength": 4, "maxLength": 20, "pattern": "^t3_[a-z0-9]+$" }, "maxItems": 100, "description": "Filter post IDs", "default": [], "title": "Filter Posts" }, "description": "Filter post IDs", "example": [] }, { "name": "language", "in": "query", "required": false, "schema": { "type": "string", "minLength": 2, "maxLength": 16, "pattern": "^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$", "description": "Preferred response language as an IETF language tag; default: en-US", "default": "en-US", "title": "Language" }, "description": "Preferred response language as an IETF language tag; default: en-US" }, { "name": "need_format", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether to clean and format the data", "default": false, "title": "Need Format" }, "description": "Whether to clean and format the data", "example": false }, { "name": "sort", "in": "query", "required": false, "schema": { "enum": [ "BEST", "HOT", "NEW", "TOP", "CONTROVERSIAL", "RISING" ], "type": "string", "description": "Sort method: BEST, HOT, NEW, TOP, CONTROVERSIAL, RISING", "default": "BEST", "title": "Sort" }, "description": "Sort method: BEST, HOT, NEW, TOP, CONTROVERSIAL, RISING", "example": "HOT" }, { "name": "subreddit_name", "in": "query", "required": true, "schema": { "type": "string", "minLength": 2, "maxLength": 21, "pattern": "^[A-Za-z0-9_]+$", "description": "Subreddit name (without r/ prefix), e.g., \"pics\", \"funny\"", "title": "Subreddit Name" }, "description": "Subreddit name (without r/ prefix), e.g., \"pics\", \"funny\"", "example": "AskReddit" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:979a951784254d6c0dc07331273b1b3ce26f59344b5364d8419e6502e507f28b" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-reddit-app-fetch_subreddit_feed" } }, "/apis/v1/tikhub/reddit/app/fetch_subreddit_info": { "get": { "description": "Reddit (app).\n\n### Purpose:\n- Fetch detailed information of a specified Reddit APP subreddit, including description, subscriber count, creation time, rules, and other metadata\n### Parameters:\n- subreddit_name: Subreddit name (without r/ prefix), e.g., \"pics\", \"funny\", \"AskReddit\"\n### Returns:\n- JSON data containing detailed subreddit information\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_reddit_app_fetch_subreddit_info", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- JSON data containing detailed subreddit information", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "reddit fetch_subreddit_info", "tags": [ "tikhub.reddit" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a90b86245d07" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/reddit/app/fetch_subreddit_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_reddit_app_fetch_subreddit_info", "method": "GET", "path": "/apis/v1/tikhub/reddit/app/fetch_subreddit_info" }, "parameters": [ { "name": "language", "in": "query", "required": false, "schema": { "type": "string", "minLength": 2, "maxLength": 16, "pattern": "^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$", "description": "Preferred response language as an IETF language tag; default: en-US", "default": "en-US", "title": "Language" }, "description": "Preferred response language as an IETF language tag; default: en-US" }, { "name": "need_format", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether to clean and format the data", "default": false, "title": "Need Format" }, "description": "Whether to clean and format the data", "example": false }, { "name": "subreddit_name", "in": "query", "required": false, "schema": { "type": "string", "minLength": 2, "maxLength": 21, "pattern": "^[A-Za-z0-9_]+$", "description": "Subreddit name (without r/ prefix), e.g., \"pics\", \"funny\", \"AskReddit\"", "default": "pics", "title": "Subreddit Name" }, "description": "Subreddit name (without r/ prefix), e.g., \"pics\", \"funny\", \"AskReddit\"", "example": "pics" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:b80ce84e94e0777029d28521cf0b395ea8411477917ddea9a5d409b4be5f629f" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-reddit-app-fetch_subreddit_info" } }, "/apis/v1/tikhub/reddit/app/fetch_subreddit_post_channels": { "get": { "description": "Reddit (app).\n\n### Purpose:\n- Fetch post channel information of a specified Reddit APP subreddit\n### Parameters:\n- subreddit_name: Subreddit name\n- sort: Sort method, supports HOT, NEW, TOP, CONTROVERSIAL, RISING\n- range: Time range, supports HOUR, DAY, WEEK, MONTH, YEAR, ALL\n### Returns:\n- JSON data of post channel information of the specified subreddit\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_reddit_app_fetch_subreddit_post_channels", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- JSON data of post channel information of the specified subreddit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "reddit fetch_subreddit_post_channels", "tags": [ "tikhub.reddit" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "bb89a431a2a6" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/reddit/app/fetch_subreddit_post_channels", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_reddit_app_fetch_subreddit_post_channels", "method": "GET", "path": "/apis/v1/tikhub/reddit/app/fetch_subreddit_post_channels" }, "parameters": [ { "name": "language", "in": "query", "required": false, "schema": { "type": "string", "minLength": 2, "maxLength": 16, "pattern": "^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$", "description": "Preferred response language as an IETF language tag; default: en-US", "default": "en-US", "title": "Language" }, "description": "Preferred response language as an IETF language tag; default: en-US" }, { "name": "need_format", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether to clean and format the data", "default": false, "title": "Need Format" }, "description": "Whether to clean and format the data", "example": false }, { "name": "range", "in": "query", "required": false, "schema": { "enum": [ "ALL", "HOUR", "DAY", "WEEK", "MONTH", "YEAR" ], "type": "string", "description": "Time range: HOUR, DAY, WEEK, MONTH, YEAR, ALL", "default": "DAY", "title": "Range" }, "description": "Time range: HOUR, DAY, WEEK, MONTH, YEAR, ALL", "example": "DAY" }, { "name": "sort", "in": "query", "required": false, "schema": { "enum": [ "BEST", "HOT", "NEW", "TOP", "CONTROVERSIAL", "RISING" ], "type": "string", "description": "Sort method: HOT, NEW, TOP, CONTROVERSIAL, RISING", "default": "HOT", "title": "Sort" }, "description": "Sort method: HOT, NEW, TOP, CONTROVERSIAL, RISING", "example": "HOT" }, { "name": "subreddit_name", "in": "query", "required": false, "schema": { "type": "string", "minLength": 2, "maxLength": 21, "pattern": "^[A-Za-z0-9_]+$", "description": "Subreddit name", "default": "pics", "title": "Subreddit Name" }, "description": "Subreddit name", "example": "pics" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:1eec5b247f42125419d7ac7cfc2280de52e3ab5c9e033bb9aff12e3772ffb70d" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-reddit-app-fetch_subreddit_post_channels" } }, "/apis/v1/tikhub/reddit/app/fetch_subreddit_settings": { "get": { "description": "Reddit (app).\n\n### Purpose:\n- Fetch settings information of a specified Reddit APP subreddit, including posting rules, flair settings, moderation settings, and other configurations\n### Parameters:\n- subreddit_id: Subreddit ID with format starting with t5_, e.g., \"t5_2qh0u\" (can be obtained from the fetch_subreddit_info endpoint)\n### Returns:\n- JSON data containing subreddit settings with the following main fields:\n - subredditType: Subreddit type (public/private/restricted)\n - submissionType: Allowed submission content types (any/link/self)\n - allowImages: Whether images are allowed\n - allowVideos: Whether videos are allowed\n - allowPolls: Whether polls are allowed\n - suggestedCommentSort: Suggested comment sort method\n - spoilersEnabled: Whether spoiler tags are enabled\n - allowedPostTypes: Allowed post types configuration\n - contentOptions: Content options settings\n - flairSettings: User/post flair settings\n### Notes:\n- You need to first get the subreddit ID (subreddit.id field) via the fetch_subreddit_info endpoint\n- Subreddit ID format must start with \"t5_\"\n- **APP API ID format differs from Web API, requires type prefix**\n- Subreddit ID prefix: t5_ (e.g., t5_2qh0u)\n\nAPI references: `fetch_subreddit_info` = `GET /tikhub/reddit/app/fetch_subreddit_info` (operationId: `get_tikhub_reddit_app_fetch_subreddit_info`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_reddit_app_fetch_subreddit_settings", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- JSON data containing subreddit settings with the following main fields:\n - subredditType: Subreddit type (public/private/restricted)\n - submissionType: Allowed submission content types (any/link/self)\n - allowImages: Whether images are allowed\n - allowVideos: Whether videos are allowed\n - allowPolls: Whether polls are allowed\n - suggestedCommentSort: Suggested comment sort method\n - spoilersEnabled: Whether spoiler tags are enabled\n - allowedPostTypes: Allowed post types configuration\n - contentOptions: Content options settings\n - flairSettings: User/post flair settings", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "reddit fetch_subreddit_settings", "tags": [ "tikhub.reddit" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "288c51d501b6" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/reddit/app/fetch_subreddit_settings", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_reddit_app_fetch_subreddit_settings", "method": "GET", "path": "/apis/v1/tikhub/reddit/app/fetch_subreddit_settings" }, "parameters": [ { "name": "language", "in": "query", "required": false, "schema": { "type": "string", "minLength": 2, "maxLength": 16, "pattern": "^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$", "description": "Preferred response language as an IETF language tag; default: en-US", "default": "en-US", "title": "Language" }, "description": "Preferred response language as an IETF language tag; default: en-US" }, { "name": "need_format", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether to clean and format the data", "default": false, "title": "Need Format" }, "description": "Whether to clean and format the data", "example": false }, { "name": "subreddit_id", "in": "query", "required": true, "schema": { "type": "string", "minLength": 4, "maxLength": 20, "pattern": "^t5_[a-z0-9]{1,17}$", "description": "Subreddit ID with format starting with t5_, e.g., \"t5_2qh0u\" (can be obtained from the fetch_subreddit_info endpoint)\n\nAPI references: `fetch_subreddit_info` = `GET /tikhub/reddit/app/fetch_subreddit_info` (operationId: `get_tikhub_reddit_app_fetch_subreddit_info`).", "title": "Subreddit Id" }, "description": "Subreddit ID with format starting with t5_, e.g., \"t5_2qh0u\" (can be obtained from the fetch_subreddit_info endpoint)\n\nAPI references: `fetch_subreddit_info` = `GET /tikhub/reddit/app/fetch_subreddit_info` (operationId: `get_tikhub_reddit_app_fetch_subreddit_info`).", "example": "t5_2qh0u" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:f39508afd278c7607475901427abd2bfbf130ffbad4ee55bff7908e903aef4c1" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/reddit/app/fetch_subreddit_settings?need_format=false&subreddit_id=t5_2qh0u' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-reddit-app-fetch_subreddit_settings" } }, "/apis/v1/tikhub/reddit/app/fetch_subreddit_style": { "get": { "description": "Reddit (app).\n\n### Purpose:\n- Fetch rules and style information of a specified Reddit APP subreddit\n### Parameters:\n- subreddit_name: Subreddit name\n### Returns:\n- JSON data of rules and style information of the specified subreddit\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_reddit_app_fetch_subreddit_style", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- JSON data of rules and style information of the specified subreddit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "reddit fetch_subreddit_style", "tags": [ "tikhub.reddit" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a7275e4cd487" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/reddit/app/fetch_subreddit_style", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_reddit_app_fetch_subreddit_style", "method": "GET", "path": "/apis/v1/tikhub/reddit/app/fetch_subreddit_style" }, "parameters": [ { "name": "language", "in": "query", "required": false, "schema": { "type": "string", "minLength": 2, "maxLength": 16, "pattern": "^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$", "description": "Preferred response language as an IETF language tag; default: en-US", "default": "en-US", "title": "Language" }, "description": "Preferred response language as an IETF language tag; default: en-US" }, { "name": "need_format", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether to clean and format the data", "default": false, "title": "Need Format" }, "description": "Whether to clean and format the data", "example": false }, { "name": "subreddit_name", "in": "query", "required": false, "schema": { "type": "string", "minLength": 2, "maxLength": 21, "pattern": "^[A-Za-z0-9_]+$", "description": "Subreddit name", "default": "pics", "title": "Subreddit Name" }, "description": "Subreddit name", "example": "pics" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:b5252cc84d148d34946ad600bbfc0d81744a05144f4d5a29b12360c61e14842a" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-reddit-app-fetch_subreddit_style" } }, "/apis/v1/tikhub/reddit/app/fetch_topic_feed": { "get": { "description": "Reddit (app).\n\n### Purpose\n- Fetch the feed for a specific Reddit community topic\n- Typical flow: call `/tikhub/reddit/app/fetch_explore_feed` first to get topicIds, then pass one here\n\n### Parameters\n- topic_id: Topic ID, format \"tx1_XXXXX\", get from `/tikhub/reddit/app/fetch_explore_feed` response's `topics[].id`\n- scheme_name: Topic scheme, App defaults to \"communities_tab_taxonomy_topics_default\"\n- sort: Sort method\n- time: Time range\n- need_format: Whether to clean\n\nAPI references: `fetch_explore_feed` = `GET /tikhub/reddit/app/fetch_explore_feed` (operationId: `get_tikhub_reddit_app_fetch_explore_feed`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_reddit_app_fetch_topic_feed", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "reddit fetch_topic_feed", "tags": [ "tikhub.reddit" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "e6e1319644da" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/reddit/app/fetch_topic_feed", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_reddit_app_fetch_topic_feed", "method": "GET", "path": "/apis/v1/tikhub/reddit/app/fetch_topic_feed" }, "parameters": [ { "name": "language", "in": "query", "required": false, "schema": { "type": "string", "minLength": 2, "maxLength": 16, "pattern": "^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$", "description": "Preferred response language as an IETF language tag; default: en-US", "default": "en-US", "title": "Language" }, "description": "Preferred response language as an IETF language tag; default: en-US" }, { "name": "need_format", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether to clean and format the data", "default": false, "title": "Need Format" }, "description": "Whether to clean and format the data", "example": false }, { "name": "scheme_name", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[a-z0-9_]+$", "description": "scheme/Topic scheme name ( App communities_tab_taxonomy_topics_default", "default": "communities_tab_taxonomy_topics_default", "title": "Scheme Name" }, "description": "scheme/Topic scheme name ( App communities_tab_taxonomy_topics_default", "example": "communities_tab_taxonomy_topics_default" }, { "name": "sort", "in": "query", "required": false, "schema": { "enum": [ "BEST", "HOT", "NEW", "TOP", "CONTROVERSIAL", "RISING" ], "type": "string", "description": "Sort method: BEST, HOT, NEW, TOP, CONTROVERSIAL", "default": "BEST", "title": "Sort" }, "description": "Sort method: BEST, HOT, NEW, TOP, CONTROVERSIAL", "example": "BEST" }, { "name": "time", "in": "query", "required": false, "schema": { "enum": [ "ALL", "HOUR", "DAY", "WEEK", "MONTH", "YEAR" ], "type": "string", "description": "Time range: ALL, HOUR, DAY, WEEK, MONTH, YEAR", "default": "ALL", "title": "Time" }, "description": "Time range: ALL, HOUR, DAY, WEEK, MONTH, YEAR", "example": "ALL" }, { "name": "topic_id", "in": "query", "required": true, "schema": { "type": "string", "minLength": 5, "maxLength": 20, "pattern": "^tx1_[a-z0-9]{1,16}$", "description": "Topic ID, format \"tx1_XXXXX\", get from `/tikhub/reddit/app/fetch_explore_feed` response's `topics[].id`\n\nAPI references: `fetch_explore_feed` = `GET /tikhub/reddit/app/fetch_explore_feed` (operationId: `get_tikhub_reddit_app_fetch_explore_feed`).", "title": "Topic Id" }, "description": "Topic ID, format \"tx1_XXXXX\", get from `/tikhub/reddit/app/fetch_explore_feed` response's `topics[].id`\n\nAPI references: `fetch_explore_feed` = `GET /tikhub/reddit/app/fetch_explore_feed` (operationId: `get_tikhub_reddit_app_fetch_explore_feed`).", "example": "tx1_29m4k39" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:27bbbea9f88f276297f7b8a4eda303b4ba36d4554a0c305527dbe53091614a42" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/reddit/app/fetch_topic_feed?need_format=false&scheme_name=communities_tab_taxonomy_topics_default&sort=BEST&time=ALL&topic_id=tx1_29m4k39' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-reddit-app-fetch_topic_feed" } }, "/apis/v1/tikhub/reddit/app/fetch_trending_searches": { "get": { "description": "Reddit (app).\n\n### Purpose:\n- Fetch currently trending search topics and content on Reddit APP\n### Parameters:\n- No parameters required\n### Returns:\n- JSON data of trending searches containing:\n - List of trending search keywords\n - Trending topics\n - Search volume and popularity for each topic\n - Related post previews\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_reddit_app_fetch_trending_searches", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- JSON data of trending searches containing:\n - List of trending search keywords\n - Trending topics\n - Search volume and popularity for each topic\n - Related post previews", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "reddit fetch_trending_searches", "tags": [ "tikhub.reddit" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "ff58a73f0e8e" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/reddit/app/fetch_trending_searches", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_reddit_app_fetch_trending_searches", "method": "GET", "path": "/apis/v1/tikhub/reddit/app/fetch_trending_searches" }, "parameters": [ { "name": "language", "in": "query", "required": false, "schema": { "type": "string", "minLength": 2, "maxLength": 16, "pattern": "^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$", "description": "Preferred response language as an IETF language tag; default: en-US", "default": "en-US", "title": "Language" }, "description": "Preferred response language as an IETF language tag; default: en-US" }, { "name": "need_format", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether to clean and format the data", "default": false, "title": "Need Format" }, "description": "Whether to clean and format the data", "example": false } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:37f739ba841a8ff72498c817a1660e6f92b657ed40fc86f38bd9d16dfba203d2" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-reddit-app-fetch_trending_searches" } }, "/apis/v1/tikhub/reddit/app/fetch_user_active_subreddits": { "get": { "description": "Reddit (app).\n\n### Purpose:\n- Fetch list of Reddit communities where the specified user is most active\n### Parameters:\n- username: Reddit username\n### Returns:\n- JSON data of user's active communities containing:\n - List of communities where user posts/comments most\n - Activity level in each community\n - Basic community information (name, icon, member count, etc.)\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_reddit_app_fetch_user_active_subreddits", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- JSON data of user's active communities containing:\n - List of communities where user posts/comments most\n - Activity level in each community\n - Basic community information (name, icon, member count, etc.)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "reddit fetch_user_active_subreddits", "tags": [ "tikhub.reddit" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "3942f627ff47" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/reddit/app/fetch_user_active_subreddits", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_reddit_app_fetch_user_active_subreddits", "method": "GET", "path": "/apis/v1/tikhub/reddit/app/fetch_user_active_subreddits" }, "parameters": [ { "name": "language", "in": "query", "required": false, "schema": { "type": "string", "minLength": 2, "maxLength": 16, "pattern": "^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$", "description": "Preferred response language as an IETF language tag; default: en-US", "default": "en-US", "title": "Language" }, "description": "Preferred response language as an IETF language tag; default: en-US" }, { "name": "need_format", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether to clean and format the data", "default": false, "title": "Need Format" }, "description": "Whether to clean and format the data", "example": false }, { "name": "username", "in": "query", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 20, "pattern": "^[A-Za-z0-9_-]+$", "description": "Username", "title": "Username" }, "description": "Username", "example": "spez" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:3206208840178c34dc33f15475a5234386b5f45865a942b4491ff13ef78597f5" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/reddit/app/fetch_user_active_subreddits?need_format=false&username=spez' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-reddit-app-fetch_user_active_subreddits" } }, "/apis/v1/tikhub/reddit/app/fetch_user_comments": { "get": { "description": "Reddit (app).\n\n### Purpose:\n- Fetch list of comments posted by the specified user\n### Parameters:\n- username: Reddit username\n- sort: Sort method, options: NEW (newest), TOP (top rated), HOT (hot), CONTROVERSIAL (controversial)\n- page_size: Number of comments per page, default 25\n- after: Pagination parameter for fetching next page\n### Returns:\n- JSON data of user comments containing:\n - Comment content\n - Information about the post where comment was made\n - Comment timestamp\n - Upvote count\n - Reply count\n - Pagination information\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_reddit_app_fetch_user_comments", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- JSON data of user comments containing:\n - Comment content\n - Information about the post where comment was made\n - Comment timestamp\n - Upvote count\n - Reply count\n - Pagination information", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "reddit fetch_user_comments", "tags": [ "tikhub.reddit" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "c5fadcab31e2" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/reddit/app/fetch_user_comments", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_reddit_app_fetch_user_comments", "method": "GET", "path": "/apis/v1/tikhub/reddit/app/fetch_user_comments" }, "parameters": [ { "name": "after", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 4096, "description": "Pagination parameter", "default": "", "title": "After" }, "description": "Pagination parameter", "example": "" }, { "name": "language", "in": "query", "required": false, "schema": { "type": "string", "minLength": 2, "maxLength": 16, "pattern": "^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$", "description": "Preferred response language as an IETF language tag; default: en-US", "default": "en-US", "title": "Language" }, "description": "Preferred response language as an IETF language tag; default: en-US" }, { "name": "need_format", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether to clean and format the data", "default": false, "title": "Need Format" }, "description": "Whether to clean and format the data", "example": false }, { "name": "page_size", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 1, "description": "Page size (default: 25", "default": 25, "title": "Page Size" }, "description": "Page size (default: 25", "example": 25 }, { "name": "sort", "in": "query", "required": false, "schema": { "enum": [ "NEW", "TOP", "HOT", "CONTROVERSIAL" ], "type": "string", "description": "Sort method, options: NEW (newest), TOP (top rated), HOT (hot), CONTROVERSIAL (controversial)", "default": "NEW", "title": "Sort" }, "description": "Sort method, options: NEW (newest), TOP (top rated), HOT (hot), CONTROVERSIAL (controversial)", "example": "NEW" }, { "name": "username", "in": "query", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 20, "pattern": "^[A-Za-z0-9_-]+$", "description": "Username", "title": "Username" }, "description": "Username", "example": "spez" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:a2833f666fcd74c74dc5627e71c3364c480bbdf2c985427726103f49d9f03091" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/reddit/app/fetch_user_comments?after=&need_format=false&page_size=25&sort=NEW&username=spez' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-reddit-app-fetch_user_comments" } }, "/apis/v1/tikhub/reddit/app/fetch_user_posts": { "get": { "description": "Reddit (app).\n\n### Purpose:\n- Fetch list of posts submitted by the specified user\n### Parameters:\n- username: Reddit username\n- sort: Sort method, options: NEW (newest), TOP (top rated), HOT (hot), CONTROVERSIAL (controversial)\n- after: Pagination parameter for fetching next page\n### Returns:\n- JSON data of user posts containing:\n - Post title and content\n - Submission time\n - Subreddit\n - Upvote and comment counts\n - Post type (text/image/video/link)\n - Media content (if any)\n - Pagination information\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_reddit_app_fetch_user_posts", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- JSON data of user posts containing:\n - Post title and content\n - Submission time\n - Subreddit\n - Upvote and comment counts\n - Post type (text/image/video/link)\n - Media content (if any)\n - Pagination information", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "reddit fetch_user_posts", "tags": [ "tikhub.reddit" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "fb53f3a7910b" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/reddit/app/fetch_user_posts", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_reddit_app_fetch_user_posts", "method": "GET", "path": "/apis/v1/tikhub/reddit/app/fetch_user_posts" }, "parameters": [ { "name": "after", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 4096, "description": "Pagination parameter", "default": "", "title": "After" }, "description": "Pagination parameter", "example": "" }, { "name": "language", "in": "query", "required": false, "schema": { "type": "string", "minLength": 2, "maxLength": 16, "pattern": "^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$", "description": "Preferred response language as an IETF language tag; default: en-US", "default": "en-US", "title": "Language" }, "description": "Preferred response language as an IETF language tag; default: en-US" }, { "name": "need_format", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether to clean and format the data", "default": false, "title": "Need Format" }, "description": "Whether to clean and format the data", "example": false }, { "name": "sort", "in": "query", "required": false, "schema": { "enum": [ "NEW", "TOP", "HOT", "CONTROVERSIAL" ], "type": "string", "description": "Sort method, options: NEW (newest), TOP (top rated), HOT (hot), CONTROVERSIAL (controversial)", "default": "NEW", "title": "Sort" }, "description": "Sort method, options: NEW (newest), TOP (top rated), HOT (hot), CONTROVERSIAL (controversial)", "example": "NEW" }, { "name": "username", "in": "query", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 20, "pattern": "^[A-Za-z0-9_-]+$", "description": "Username", "title": "Username" }, "description": "Username", "example": "spez" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:4034666d40ceba818394c2db868daf9f517efbe21dd6b540a49ae2f44047f633" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/reddit/app/fetch_user_posts?after=&need_format=false&sort=NEW&username=spez' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-reddit-app-fetch_user_posts" } }, "/apis/v1/tikhub/reddit/app/fetch_user_profile": { "get": { "description": "Reddit (app).\n\n### Purpose:\n- Fetch detailed profile information of a specified Reddit APP user\n### Parameters:\n- username: Reddit username (without u/ prefix)\n### Returns:\n- JSON data of user profile containing:\n - Username and ID\n - Account creation date\n - Karma values (post karma and comment karma)\n - Avatar and banner images\n - Bio/description\n - Verification status\n - Badges and awards\n - Follower count\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_reddit_app_fetch_user_profile", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- JSON data of user profile containing:\n - Username and ID\n - Account creation date\n - Karma values (post karma and comment karma)\n - Avatar and banner images\n - Bio/description\n - Verification status\n - Badges and awards\n - Follower count", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "reddit fetch_user_profile", "tags": [ "tikhub.reddit" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "01dc4790b470" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/reddit/app/fetch_user_profile", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_reddit_app_fetch_user_profile", "method": "GET", "path": "/apis/v1/tikhub/reddit/app/fetch_user_profile" }, "parameters": [ { "name": "language", "in": "query", "required": false, "schema": { "type": "string", "minLength": 2, "maxLength": 16, "pattern": "^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$", "description": "Preferred response language as an IETF language tag; default: en-US", "default": "en-US", "title": "Language" }, "description": "Preferred response language as an IETF language tag; default: en-US" }, { "name": "need_format", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether to clean and format the data", "default": false, "title": "Need Format" }, "description": "Whether to clean and format the data", "example": false }, { "name": "username", "in": "query", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 20, "pattern": "^[A-Za-z0-9_-]+$", "description": "Reddit username (without u/ prefix)", "title": "Username" }, "description": "Reddit username (without u/ prefix)", "example": "spez" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:a9cf6c4ef1ff4ffe8f560dad250152acf107d3e2cbd7719db54d37dda13e8a61" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/reddit/app/fetch_user_profile?need_format=false&username=spez' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-reddit-app-fetch_user_profile" } }, "/apis/v1/tikhub/reddit/app/fetch_user_trophies": { "get": { "description": "Reddit (app).\n\n### Purpose:\n- Fetch public trophies/achievements list of a specified Reddit user\n### Parameters:\n- username: Reddit username (without u/ prefix)\n### Returns:\n- JSON data of user trophies containing:\n - Trophy list\n - Detailed information for each trophy:\n - Trophy name\n - Trophy description\n - Trophy icon URL\n - Award date\n - Special badges and achievements\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_reddit_app_fetch_user_trophies", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- JSON data of user trophies containing:\n - Trophy list\n - Detailed information for each trophy:\n - Trophy name\n - Trophy description\n - Trophy icon URL\n - Award date\n - Special badges and achievements", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "reddit fetch_user_trophies", "tags": [ "tikhub.reddit" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "3f9d228d15bd" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/reddit/app/fetch_user_trophies", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_reddit_app_fetch_user_trophies", "method": "GET", "path": "/apis/v1/tikhub/reddit/app/fetch_user_trophies" }, "parameters": [ { "name": "language", "in": "query", "required": false, "schema": { "type": "string", "minLength": 2, "maxLength": 16, "pattern": "^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$", "description": "Preferred response language as an IETF language tag; default: en-US", "default": "en-US", "title": "Language" }, "description": "Preferred response language as an IETF language tag; default: en-US" }, { "name": "need_format", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether to clean and format the data", "default": false, "title": "Need Format" }, "description": "Whether to clean and format the data", "example": false }, { "name": "username", "in": "query", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 20, "pattern": "^[A-Za-z0-9_-]+$", "description": "Reddit username (without u/ prefix)", "title": "Username" }, "description": "Reddit username (without u/ prefix)", "example": "spez" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:751fcdec72643907605f0b4ad6dc3b05089b86e2de58f8ec9a420592ff50029d" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/reddit/app/fetch_user_trophies?need_format=false&username=spez' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-reddit-app-fetch_user_trophies" } }, "/apis/v1/tikhub/telegram/web/batch_channel_info": { "get": { "description": "Telegram (web).\n\n### Purpose:\n- Fetch basic info (title/description/avatar/subscribers/verified) for multiple public channels concurrently.\n\n### Parameters:\n- channels: Comma-separated channel usernames, up to 20 per request.\n\n### Return:\n- `data.results`: one `{channel, ok, info|error}` entry per channel.\n\n\nPublished reference price: $0.008 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_telegram_web_batch_channel_info", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `data.results`: one `{channel, ok, info|error}` entry per channel.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "telegram batch_channel_info", "tags": [ "tikhub.telegram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.008, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "078612f89a23" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/telegram/web/batch_channel_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_telegram_web_batch_channel_info", "method": "GET", "path": "/apis/v1/tikhub/telegram/web/batch_channel_info" }, "parameters": [ { "name": "channels", "in": "query", "required": true, "schema": { "type": "string", "description": "Comma-separated channel usernames; send no more than 20 per request.", "title": "Channels", "pattern": "^[^,]*(?:,[^,]*){0,19}$" }, "description": "Comma-separated channel usernames; send no more than 20 per request.", "example": "durov,telegram" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:32ae7e17f00f7359d315a6f6c53b52068d2226294b61e3e6d5de47b8d0ef7e5f" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/telegram/web/batch_channel_info?channels=durov%2Ctelegram' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-telegram-web-batch_channel_info" } }, "/apis/v1/tikhub/telegram/web/fetch_channel_info": { "get": { "description": "Telegram (web).\n\n### Purpose:\n- Get public Telegram channel metadata: title, description, avatar, subscriber count, verified badge and media counters.\n- Data comes from the public t.me preview page, no login required.\n\n### Parameters:\n- channel: Channel username (accepts `durov` / `@durov` / `https://t.me/durov`, normalized automatically).\n\n### Return:\n- `username` / `title` / `verified` / `description` / `photo` / `subscribers` / `counters`.\n- Returns `exists = false` when the channel does not exist or is not public; `preview_available = false` when the channel disabled web preview.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_telegram_web_fetch_channel_info", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `username` / `title` / `verified` / `description` / `photo` / `subscribers` / `counters`.\n- Returns `exists = false` when the channel does not exist or is not public; `preview_available = false` when the channel disabled web preview.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "telegram fetch_channel_info", "tags": [ "tikhub.telegram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "58f08837c4da" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/telegram/web/fetch_channel_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_telegram_web_fetch_channel_info", "method": "GET", "path": "/apis/v1/tikhub/telegram/web/fetch_channel_info" }, "parameters": [ { "name": "channel", "in": "query", "required": true, "schema": { "type": "string", "description": "Channel username (accepts `durov` / `@durov` / `https://t.me/durov`, normalized automatically).", "title": "Channel" }, "description": "Channel username (accepts `durov` / `@durov` / `https://t.me/durov`, normalized automatically).", "example": "durov" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:90466d3b91e46ad489b54d200be40f4680ed2c903d2d3e225f1015a9abb65f4b" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/telegram/web/fetch_channel_info?channel=durov' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-telegram-web-fetch_channel_info" } }, "/apis/v1/tikhub/telegram/web/fetch_channel_posts": { "get": { "description": "Telegram (web).\n\n### Purpose:\n- Fetch a public channel's recent posts (text, photos, videos, forwards, replies, link previews, reactions, views, time).\n\n### Parameters:\n- channel: Channel username (required).\n- limit: Number of posts (1-100, default 20; when >20 the server automatically pages toward older posts).\n- before: Pagination cursor — fetch older posts, pass `data.pagination.before_cursor` from the previous page.\n- after: Pagination cursor — fetch newer posts, pass `data.pagination.after_cursor` from the previous page.\n\n### Return:\n- `channel_info` (same structure as fetch_channel_info), `messages` array and a `pagination` cursor object.\n- Media direct links (cdn4.telesco.pe) are signed and expire — download / re-host them promptly.\n\nAPI references: `fetch_channel_info` = `GET /tikhub/telegram/web/fetch_channel_info` (operationId: `get_tikhub_telegram_web_fetch_channel_info`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_telegram_web_fetch_channel_posts", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `channel_info` (same structure as fetch_channel_info), `messages` array and a `pagination` cursor object.\n- Media direct links (cdn4.telesco.pe) are signed and expire — download / re-host them promptly.\n\nAPI references: `fetch_channel_info` = `GET /tikhub/telegram/web/fetch_channel_info` (operationId: `get_tikhub_telegram_web_fetch_channel_info`).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "telegram fetch_channel_posts", "tags": [ "tikhub.telegram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "2a83926ff914" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/telegram/web/fetch_channel_posts", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_telegram_web_fetch_channel_posts", "method": "GET", "path": "/apis/v1/tikhub/telegram/web/fetch_channel_posts" }, "parameters": [ { "name": "after", "in": "query", "required": false, "schema": { "type": "integer", "description": "Newer than this id\n\nUsage: Pagination cursor — fetch newer posts, pass `data.pagination.after_cursor` from the previous page.", "default": 0, "title": "After" }, "description": "Newer than this id\n\nUsage: Pagination cursor — fetch newer posts, pass `data.pagination.after_cursor` from the previous page.", "example": 0 }, { "name": "before", "in": "query", "required": false, "schema": { "type": "integer", "description": "Older than this id\n\nUsage: Pagination cursor — fetch older posts, pass `data.pagination.before_cursor` from the previous page.", "default": 0, "title": "Before" }, "description": "Older than this id\n\nUsage: Pagination cursor — fetch older posts, pass `data.pagination.before_cursor` from the previous page.", "example": 0 }, { "name": "channel", "in": "query", "required": true, "schema": { "type": "string", "description": "Channel username", "title": "Channel" }, "description": "Channel username", "example": "durov" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 1, "description": "Number of posts (1-100, default 20; when >20 the server automatically pages toward older posts).", "default": 20, "title": "Limit" }, "description": "Number of posts (1-100, default 20; when >20 the server automatically pages toward older posts).", "example": 20 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:a68a392d3300d9abf8ba3777dd496a71d6cbd08d0813aa84d635d5997529a58d" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/telegram/web/fetch_channel_posts?after=0&before=0&channel=durov&limit=20' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-telegram-web-fetch_channel_posts" } }, "/apis/v1/tikhub/telegram/web/fetch_channel_search": { "get": { "description": "Telegram (web).\n\n### Purpose:\n- Search posts in a channel by keyword (case-insensitive).\n- Uses Telegram's server-side search over the full channel history when the MTProto backend\n is enabled (`data.backend = \"mtproto\"`); otherwise falls back to best-effort local filtering\n over recent history (`data.backend = \"web\"`).\n\n### Parameters:\n- channel: Channel username (required).\n- query: Keyword (required).\n- limit: Number of hits (1-100, default 20).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_telegram_web_fetch_channel_search", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "telegram fetch_channel_search", "tags": [ "tikhub.telegram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "99df8a961e6f" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/telegram/web/fetch_channel_search", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_telegram_web_fetch_channel_search", "method": "GET", "path": "/apis/v1/tikhub/telegram/web/fetch_channel_search" }, "parameters": [ { "name": "channel", "in": "query", "required": true, "schema": { "type": "string", "description": "Channel username", "title": "Channel" }, "description": "Channel username", "example": "durov" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 1, "description": "Number of hits (1-100, default 20).", "default": 20, "title": "Limit" }, "description": "Number of hits (1-100, default 20).", "example": 20 }, { "name": "query", "in": "query", "required": true, "schema": { "type": "string", "description": "Keyword", "title": "Query" }, "description": "Keyword", "example": "TON" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:27bbbea9f88f276297f7b8a4eda303b4ba36d4554a0c305527dbe53091614a42" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/telegram/web/fetch_channel_search?channel=durov&limit=20&query=TON' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-telegram-web-fetch_channel_search" } }, "/apis/v1/tikhub/telegram/web/fetch_post_comments": { "get": { "description": "Telegram (web).\n\n### Purpose:\n- Fetch comments of a channel post from its **linked discussion group**.\n\n### Parameters:\n- channel: Channel username; post_id: Post ID; limit: number of comments (1-100).\n\n### Return:\n- Comment list; empty when the channel has comments disabled / no linked discussion group.\n- Returns `mtproto_required = true` with a hint when the MTProto backend is not enabled.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_telegram_web_fetch_post_comments", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Comment list; empty when the channel has comments disabled / no linked discussion group.\n- Returns `mtproto_required = true` with a hint when the MTProto backend is not enabled.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "telegram fetch_post_comments", "tags": [ "tikhub.telegram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "0de4ad5c4ccc" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/telegram/web/fetch_post_comments", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_telegram_web_fetch_post_comments", "method": "GET", "path": "/apis/v1/tikhub/telegram/web/fetch_post_comments" }, "parameters": [ { "name": "channel", "in": "query", "required": true, "schema": { "type": "string", "description": "Channel username; post_id: Post ID; limit: number of comments (1-100).", "title": "Channel" }, "description": "Channel username; post_id: Post ID; limit: number of comments (1-100).", "example": "durov" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 1, "description": "Number of comments", "default": 50, "title": "Limit" }, "description": "Number of comments", "example": 50 }, { "name": "post_id", "in": "query", "required": true, "schema": { "type": "integer", "description": "Post ID", "title": "Post Id" }, "description": "Post ID", "example": 510 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:b1341a1c54de8da59f789563991574d0fcbdd41d31acee734ae849d3c2e88f0a" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/telegram/web/fetch_post_comments?channel=durov&limit=50&post_id=510' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-telegram-web-fetch_post_comments" } }, "/apis/v1/tikhub/telegram/web/fetch_post_detail": { "get": { "description": "Telegram (web).\n\n### Purpose:\n- Get a single public-channel post (parsed from the t.me embed view).\n\n### Parameters:\n- channel: Channel username (required).\n- post_id: Post ID (required, auto-incremented integer within the channel).\n\n### Return:\n- A single post object (same structure as a `messages` element in fetch_channel_posts).\n\nAPI references: `fetch_channel_posts` = `GET /tikhub/telegram/web/fetch_channel_posts` (operationId: `get_tikhub_telegram_web_fetch_channel_posts`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_telegram_web_fetch_post_detail", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- A single post object (same structure as a `messages` element in fetch_channel_posts).\n\nAPI references: `fetch_channel_posts` = `GET /tikhub/telegram/web/fetch_channel_posts` (operationId: `get_tikhub_telegram_web_fetch_channel_posts`).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "telegram fetch_post_detail", "tags": [ "tikhub.telegram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "9482b7529b8f" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/telegram/web/fetch_post_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_telegram_web_fetch_post_detail", "method": "GET", "path": "/apis/v1/tikhub/telegram/web/fetch_post_detail" }, "parameters": [ { "name": "channel", "in": "query", "required": true, "schema": { "type": "string", "description": "Channel username", "title": "Channel" }, "description": "Channel username", "example": "durov" }, { "name": "post_id", "in": "query", "required": true, "schema": { "type": "integer", "description": "Post ID (required, auto-incremented integer within the channel).", "title": "Post Id" }, "description": "Post ID (required, auto-incremented integer within the channel).", "example": 510 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e0717064edc08ec037b21f25f76184460df95b2db16186265cc4962479982951" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/telegram/web/fetch_post_detail?channel=durov&post_id=510' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-telegram-web-fetch_post_detail" } }, "/apis/v1/tikhub/telegram/web/fetch_similar_channels": { "get": { "description": "Telegram (web).\n\n### Purpose:\n- Get Telegram's official \"similar channels\" recommendations (for channel discovery).\n\n### Parameters:\n- channel: Channel username.\n\n### Return:\n- List of similar channels (title/username/subscribers, etc.).\n- Returns `mtproto_required = true` with a hint when the MTProto backend is not enabled.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_telegram_web_fetch_similar_channels", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- List of similar channels (title/username/subscribers, etc.).\n- Returns `mtproto_required = true` with a hint when the MTProto backend is not enabled.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "telegram fetch_similar_channels", "tags": [ "tikhub.telegram" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "54682f8e69fd" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/telegram/web/fetch_similar_channels", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_telegram_web_fetch_similar_channels", "method": "GET", "path": "/apis/v1/tikhub/telegram/web/fetch_similar_channels" }, "parameters": [ { "name": "channel", "in": "query", "required": true, "schema": { "type": "string", "description": "Channel username", "title": "Channel" }, "description": "Channel username", "example": "durov" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:1c30afb8bf4274eb0cf1024948ac0107213d2a7095c3db736d7444c3093c0d68" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/telegram/web/fetch_similar_channels?channel=durov' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-telegram-web-fetch_similar_channels" } }, "/apis/v1/tikhub/threads/web/fetch_post_comments": { "get": { "description": "Threads (web). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get Threads post comments list\n\n### ⚠️ No pagination\n- A single call returns all available data (~25 items). There is no way to fetch more.\n- The `end_cursor` parameter is reserved and currently has no effect — do not rely on it.\n\n### Parameters\n- post_id: Post ID, for example: 3390920896561588969\n- end_cursor: Pagination cursor. No pagination supported; passing it has no effect\n\n### Return\n- Post comments list data, including:\n - comments: Comment list\n - next_cursor: Next page cursor (always null)\n - has_more: Has more data\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_threads_web_fetch_post_comments", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Post comments list data, including:\n - comments: Comment list\n - next_cursor: Next page cursor (always null)\n - has_more: Has more data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "threads fetch_post_comments", "tags": [ "tikhub.threads" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "ebdf3ad0ce0c" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/threads/web/fetch_post_comments", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_threads_web_fetch_post_comments", "method": "GET", "path": "/apis/v1/tikhub/threads/web/fetch_post_comments" }, "parameters": [ { "name": "end_cursor", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination cursor (no pagination, has no effect", "title": "End Cursor" }, "description": "Pagination cursor (no pagination, has no effect" }, { "name": "post_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Post ID, for example: 3390920896561588969", "title": "Post Id" }, "description": "Post ID, for example: 3390920896561588969", "example": "3390920896561588969" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:69ee46d8d36acb8158634ea17554816697e6efce1061d9df303ef1431b8b2aee" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/threads/web/fetch_post_comments?post_id=3390920896561588969' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-threads-web-fetch_post_comments" } }, "/apis/v1/tikhub/threads/web/fetch_post_detail": { "get": { "description": "Threads (web). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get Threads post detail\n\n### Parameters\n- post_id: Post ID as a numeric string, for example \"3349029093483693129\". For a URL or shortcode, the official prerequisite is `GET /api/v1/threads/web/fetch_post_detail_v2` (upstream-only; not exposed in this specification). Its input uses a Threads URL or shortcode. This operation requires the numeric Threads post ID.\n\n### Return\n- Post detail data, including:\n - id: Post ID\n - text: Post text content\n - user: Publisher information\n - image_versions2: Image information\n - video_versions: Video information\n - like_count: Like count\n - text_post_app_info: Post app information\n - etc...\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_threads_web_fetch_post_detail", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Post detail data, including:\n - id: Post ID\n - text: Post text content\n - user: Publisher information\n - image_versions2: Image information\n - video_versions: Video information\n - like_count: Like count\n - text_post_app_info: Post app information\n - etc...", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "threads fetch_post_detail", "tags": [ "tikhub.threads" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "02f65f6aa2db" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/threads/web/fetch_post_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_threads_web_fetch_post_detail", "method": "GET", "path": "/apis/v1/tikhub/threads/web/fetch_post_detail" }, "parameters": [ { "name": "post_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Post ID as a numeric string, for example \"3349029093483693129\". For a URL or shortcode, the official prerequisite is `GET /api/v1/threads/web/fetch_post_detail_v2` (upstream-only; not exposed in this specification). Its input uses a Threads URL or shortcode. This operation requires the numeric Threads post ID.", "title": "Post Id" }, "description": "Post ID as a numeric string, for example \"3349029093483693129\". For a URL or shortcode, the official prerequisite is `GET /api/v1/threads/web/fetch_post_detail_v2` (upstream-only; not exposed in this specification). Its input uses a Threads URL or shortcode. This operation requires the numeric Threads post ID.", "example": "3349029093483693129" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:a33032a5103625ba92982c51845e907bb3d401b130ec4870a6513349b0c18828" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/threads/web/fetch_post_detail?post_id=3349029093483693129' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-threads-web-fetch_post_detail" } }, "/apis/v1/tikhub/threads/web/fetch_user_info": { "get": { "description": "Threads (web). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get Threads user information\n\n### Parameters\n- username: Username, for example: jlo, can be obtained from the user's homepage link, for example: jlo in https://www.threads.net/@jlo\n\n### Return\n- User information data, including:\n - pk: User ID\n - username: Username\n - full_name: Full name\n - biography: Biography\n - profile_pic_url: Profile picture URL\n - follower_count: Follower count\n - is_verified: Is verified\n - bio_links: External links in the biography\n - etc...\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_threads_web_fetch_user_info", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- User information data, including:\n - pk: User ID\n - username: Username\n - full_name: Full name\n - biography: Biography\n - profile_pic_url: Profile picture URL\n - follower_count: Follower count\n - is_verified: Is verified\n - bio_links: External links in the biography\n - etc...", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "threads fetch_user_info", "tags": [ "tikhub.threads" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "01c30b755217" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/threads/web/fetch_user_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_threads_web_fetch_user_info", "method": "GET", "path": "/apis/v1/tikhub/threads/web/fetch_user_info" }, "parameters": [ { "name": "username", "in": "query", "required": true, "schema": { "type": "string", "description": "Username, for example: jlo, can be obtained from the user's homepage link, for example: jlo in https://www.threads.net/@jlo", "title": "Username" }, "description": "Username, for example: jlo, can be obtained from the user's homepage link, for example: jlo in https://www.threads.net/@jlo", "example": "lilbieber" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e07c76652ec425f1b9e826aa8bd2c5fdbb687326808bcbbcbc5392486b2bc7cd" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/threads/web/fetch_user_info?username=lilbieber' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-threads-web-fetch_user_info" } }, "/apis/v1/tikhub/threads/web/fetch_user_info_by_id": { "get": { "description": "Threads (web). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get Threads user information by user ID\n\n### Parameters\n- user_id: User ID, for example: 67027868801, can be obtained from user profile API or post data\n\n### Return\n- User information data, including:\n - pk: User ID\n - username: Username\n - full_name: Full name\n - biography: Biography\n - profile_pic_url: Profile picture URL\n - follower_count: Follower count\n - is_verified: Is verified\n - bio_links: External links in the biography\n - etc...\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_threads_web_fetch_user_info_by_id", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- User information data, including:\n - pk: User ID\n - username: Username\n - full_name: Full name\n - biography: Biography\n - profile_pic_url: Profile picture URL\n - follower_count: Follower count\n - is_verified: Is verified\n - bio_links: External links in the biography\n - etc...", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "threads fetch_user_info_by_id", "tags": [ "tikhub.threads" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a5a9b625f197" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/threads/web/fetch_user_info_by_id", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_threads_web_fetch_user_info_by_id", "method": "GET", "path": "/apis/v1/tikhub/threads/web/fetch_user_info_by_id" }, "parameters": [ { "name": "user_id", "in": "query", "required": true, "schema": { "type": "string", "description": "User ID, for example: 67027868801, can be obtained from user profile API or post data", "title": "User Id" }, "description": "User ID, for example: 67027868801, can be obtained from user profile API or post data", "example": "67027868801" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e07c76652ec425f1b9e826aa8bd2c5fdbb687326808bcbbcbc5392486b2bc7cd" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/threads/web/fetch_user_info_by_id?user_id=67027868801' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-threads-web-fetch_user_info_by_id" } }, "/apis/v1/tikhub/threads/web/fetch_user_posts": { "get": { "description": "Threads (web). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get Threads user's post list\n\n### ⚠️ No pagination\n- A single call returns all available data (~25 items). There is no way to fetch more.\n- The `end_cursor` parameter is reserved and currently has no effect — do not rely on it.\n\n### Parameters\n- user_id: User ID, for example: 63625256886, can be obtained from user profile API\n- end_cursor: Pagination cursor. No pagination supported; passing it has no effect\n\n### Return\n- User post list data, including:\n - threads: Post list array\n - next_cursor: Next page cursor (always null)\n - has_more: Has more data\n - Each post contains:\n - id: Post ID\n - text: Post text content\n - user: Publisher information\n - image_versions2: Image information\n - video_versions: Video information\n - like_count: Like count\n - text_post_app_info: Post app information\n - etc...\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_threads_web_fetch_user_posts", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- User post list data, including:\n - threads: Post list array\n - next_cursor: Next page cursor (always null)\n - has_more: Has more data\n - Each post contains:\n - id: Post ID\n - text: Post text content\n - user: Publisher information\n - image_versions2: Image information\n - video_versions: Video information\n - like_count: Like count\n - text_post_app_info: Post app information\n - etc...", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "threads fetch_user_posts", "tags": [ "tikhub.threads" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "e7dd8ec21050" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/threads/web/fetch_user_posts", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_threads_web_fetch_user_posts", "method": "GET", "path": "/apis/v1/tikhub/threads/web/fetch_user_posts" }, "parameters": [ { "name": "end_cursor", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination cursor (no pagination, has no effect", "title": "End Cursor" }, "description": "Pagination cursor (no pagination, has no effect" }, { "name": "user_id", "in": "query", "required": true, "schema": { "type": "string", "description": "User ID, for example: 63625256886, can be obtained from user profile API", "title": "User Id" }, "description": "User ID, for example: 63625256886, can be obtained from user profile API", "example": "63625256886" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:4d8b941a8cf02419f2adb7a69f583724a6b1e3d089b54f596608ccae0ee92629" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/threads/web/fetch_user_posts?user_id=63625256886' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-threads-web-fetch_user_posts" } }, "/apis/v1/tikhub/threads/web/fetch_user_replies": { "get": { "description": "Threads (web). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get Threads user's reply list\n\n### ⚠️ No pagination\n- A single call returns all available data (~25 items). There is no way to fetch more.\n- The `end_cursor` parameter is reserved and currently has no effect — do not rely on it.\n\n### Parameters\n- user_id: User ID, for example: 63625256886\n- end_cursor: Pagination cursor. No pagination supported; passing it has no effect\n\n### Return\n- User reply list data, including:\n - threads: Reply list\n - next_cursor: Next page cursor (always null)\n - has_more: Has more data\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_threads_web_fetch_user_replies", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- User reply list data, including:\n - threads: Reply list\n - next_cursor: Next page cursor (always null)\n - has_more: Has more data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "threads fetch_user_replies", "tags": [ "tikhub.threads" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "7dd81a2599cf" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/threads/web/fetch_user_replies", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_threads_web_fetch_user_replies", "method": "GET", "path": "/apis/v1/tikhub/threads/web/fetch_user_replies" }, "parameters": [ { "name": "end_cursor", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination cursor (no pagination, has no effect", "title": "End Cursor" }, "description": "Pagination cursor (no pagination, has no effect" }, { "name": "user_id", "in": "query", "required": true, "schema": { "type": "string", "description": "User ID, for example: 63625256886", "title": "User Id" }, "description": "User ID, for example: 63625256886", "example": "63625256886" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:274a0b65685daee86e92675c9c3c49d68334e15c3d23506b11f0bbed05980fbc" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/threads/web/fetch_user_replies?user_id=63625256886' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-threads-web-fetch_user_replies" } }, "/apis/v1/tikhub/threads/web/fetch_user_reposts": { "get": { "description": "Threads (web). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get Threads user's repost list\n\n### ⚠️ No pagination\n- A single call returns all available data (~25 items). There is no way to fetch more.\n- The `end_cursor` parameter is reserved and currently has no effect — do not rely on it.\n\n### Parameters\n- user_id: User ID, for example: 63625256886\n- end_cursor: Pagination cursor. No pagination supported; passing it has no effect\n\n### Return\n- User repost list data, including:\n - threads: Repost list\n - next_cursor: Next page cursor (always null)\n - has_more: Has more data\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_threads_web_fetch_user_reposts", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- User repost list data, including:\n - threads: Repost list\n - next_cursor: Next page cursor (always null)\n - has_more: Has more data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "threads fetch_user_reposts", "tags": [ "tikhub.threads" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "0e85a3634e7d" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/threads/web/fetch_user_reposts", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_threads_web_fetch_user_reposts", "method": "GET", "path": "/apis/v1/tikhub/threads/web/fetch_user_reposts" }, "parameters": [ { "name": "end_cursor", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination cursor (no pagination, has no effect", "title": "End Cursor" }, "description": "Pagination cursor (no pagination, has no effect" }, { "name": "user_id", "in": "query", "required": true, "schema": { "type": "string", "description": "User ID, for example: 63625256886", "title": "User Id" }, "description": "User ID, for example: 63625256886", "example": "63625256886" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:5f6ed44d9d3357042bef05e3f5667d25615d638478cad2dfad7f667c7b5517b0" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/threads/web/fetch_user_reposts?user_id=63625256886' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-threads-web-fetch_user_reposts" } }, "/apis/v1/tikhub/threads/web/search_profiles": { "get": { "description": "Threads (web). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Search Threads user profiles\n\n### Parameters\n- query: Search query, for example: mark\n\n### Return\n- Search result data, including:\n - users: User list\n - Each user contains:\n - pk: User ID\n - username: Username\n - full_name: Full name\n - profile_pic_url: Profile picture URL\n - is_verified: Is verified\n - follower_count: Follower count\n - etc...\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_threads_web_search_profiles", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Search result data, including:\n - users: User list\n - Each user contains:\n - pk: User ID\n - username: Username\n - full_name: Full name\n - profile_pic_url: Profile picture URL\n - is_verified: Is verified\n - follower_count: Follower count\n - etc...", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "threads search_profiles", "tags": [ "tikhub.threads" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "1484ef3f2796" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/threads/web/search_profiles", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_threads_web_search_profiles", "method": "GET", "path": "/apis/v1/tikhub/threads/web/search_profiles" }, "parameters": [ { "name": "query", "in": "query", "required": true, "schema": { "type": "string", "description": "Search query", "title": "Query" }, "description": "Search query", "example": "mark" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:af31dd876b4fc9769acea69a7819e752d47bedfb9e26ca15fa61298cae1297be" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/threads/web/search_profiles?query=mark' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-threads-web-search_profiles" } }, "/apis/v1/tikhub/tiktok/ads/get_ad_interactive_analysis": { "post": { "description": "TikTok (ads).\n\n### Purpose\n- Get ad interactive time analysis to understand audience retention and engagement at different video time points\n- Analyze ad video attractiveness curve to find optimal duration and key interaction points\n- Optimize ad content structure to improve overall effectiveness\n\n### Parameters\n- material_id: Ad material ID, required parameter\n- metric_type: Analysis type\n - ctr: Click-through rate analysis\n - cvr: Conversion rate analysis\n - clicks: Click count analysis\n - conversion: Conversion count analysis\n - remain: Retention rate analysis (default)\n- period_type: Time range, default 180 days\n- cookie: Custom Cookie string, optional parameter, can be used to fetch more data\n\n### Return Description\n- `interactive_data`: Interactive analysis data\n - `time_series`: Time series data\n - `time`: Video playback time point (seconds)\n - `value`: Corresponding metric value (e.g., retention rate)\n - `average_watch_time`: Average watch time\n - `completion_rate`: Completion rate\n - `peak_interaction_time`: Peak interaction time point\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_tiktok_ads_get_ad_interactive_analysis", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return Description\n- `interactive_data`: Interactive analysis data\n - `time_series`: Time series data\n - `time`: Video playback time point (seconds)\n - `value`: Corresponding metric value (e.g., retention rate)\n - `average_watch_time`: Average watch time\n - `completion_rate`: Completion rate\n - `peak_interaction_time`: Peak interaction time point\n\nThe media-type example is an illustrative response from the official documentation, not a live response. Its router and params metadata use upstream naming.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" }, "example": { "code": 200, "router": "/api/v1/tiktok/ads/get_ad_interactive_analysis", "params": { "material_id": "7213258221116751874", "metric_type": "remain", "period_type": 180 }, "data": { "interactive_data": { "time_series": [ { "time": 0, "value": 100 }, { "time": 1, "value": 95 }, { "time": 2, "value": 88 } ], "average_watch_time": 8.5, "completion_rate": 65.2, "peak_interaction_time": 3 } } } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok get_ad_interactive_analysis", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "503eee35063d" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/ads/get_ad_interactive_analysis", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_tiktok_ads_get_ad_interactive_analysis", "method": "POST", "path": "/apis/v1/tikhub/tiktok/ads/get_ad_interactive_analysis" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "material_id": { "type": "string", "title": "Material Id", "description": "Ad material ID" }, "metric_type": { "type": "string", "title": "Metric Type", "description": "Analysis type\n - ctr: Click-through rate analysis\n - cvr: Conversion rate analysis\n - clicks: Click count analysis\n - conversion: Conversion count analysis\n - remain: Retention rate analysis (default)", "default": "remain" }, "period_type": { "type": "integer", "title": "Period Type", "description": "Period type (days)\n\nUsage: Time range, default 180 days", "default": 180 }, "cookie": { "type": "string", "title": "Cookie", "description": "Custom Cookie string, optional parameter, can be used to fetch more data" } }, "type": "object", "required": [ "material_id" ], "title": "Body_get_ad_interactive_analysis_api_v1_tiktok_ads_get_ad_interactive_analysis_post" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:19f4d0415190177352fc414abbe7ff4d3f47fe339226fcabeb0026abf1bf2436" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-tiktok-ads-get_ad_interactive_analysis" } }, "/apis/v1/tikhub/tiktok/ads/get_ad_keyframe_analysis": { "post": { "description": "TikTok (ads).\n\n### Purpose\n- Get keyframe analysis of ad videos to understand audience retention at different time points\n- Analyze which time points attract viewers most and where viewers drop off\n- Help optimize ad video structure to improve completion rates\n\n### Parameters\n- material_id: Ad material ID, required parameter\n- metric: Analysis metric, options:\n - retain_ctr: Retention CTR (default)\n - retain_cvr: Retention CVR\n - click_cnt: Click count\n - convert_cnt: Conversion count\n - play_retain_cnt: Play retention count\n- cookie: Custom Cookie string, optional parameter, can be used to fetch more data\n\n### Return Description\n- `keyframe_data`: Keyframe data\n - `time_points`: List of time points (seconds)\n - `retention_rates`: Retention rates at corresponding time points (percentage)\n - `drop_points`: Time points with high drop-off rates\n - `highlight_points`: Time points with high viewer interest\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_tiktok_ads_get_ad_keyframe_analysis", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return Description\n- `keyframe_data`: Keyframe data\n - `time_points`: List of time points (seconds)\n - `retention_rates`: Retention rates at corresponding time points (percentage)\n - `drop_points`: Time points with high drop-off rates\n - `highlight_points`: Time points with high viewer interest\n\nThe media-type example is an illustrative response from the official documentation, not a live response. Its router and params metadata use upstream naming.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" }, "example": { "code": 200, "router": "/api/v1/tiktok/ads/get_ad_keyframe_analysis", "params": { "material_id": "7213258221116751874" }, "data": { "keyframe_data": { "time_points": [ 0, 1, 2, 3, 4, 5 ], "retention_rates": [ 100, 95, 88, 82, 78, 75 ], "drop_points": [ 2, 4 ], "highlight_points": [ 1, 5 ] } } } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok get_ad_keyframe_analysis", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "58ff31bac294" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/ads/get_ad_keyframe_analysis", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_tiktok_ads_get_ad_keyframe_analysis", "method": "POST", "path": "/apis/v1/tikhub/tiktok/ads/get_ad_keyframe_analysis" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "material_id": { "type": "string", "title": "Material Id", "description": "Ad material ID" }, "metric": { "type": "string", "title": "Metric", "description": "Analysis metric, options:\n - retain_ctr: Retention CTR (default)\n - retain_cvr: Retention CVR\n - click_cnt: Click count\n - convert_cnt: Conversion count\n - play_retain_cnt: Play retention count", "default": "retain_ctr" }, "cookie": { "type": "string", "title": "Cookie", "description": "Custom Cookie string, optional parameter, can be used to fetch more data" } }, "type": "object", "required": [ "material_id" ], "title": "Body_get_ad_keyframe_analysis_api_v1_tiktok_ads_get_ad_keyframe_analysis_post" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:bbaaea3ea667b955453c4ec5fc0e33a78c84f840ace4f563967b13b619721c0a" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-tiktok-ads-get_ad_keyframe_analysis" } }, "/apis/v1/tikhub/tiktok/ads/get_ad_percentile": { "post": { "description": "TikTok (ads).\n\n### Purpose\n- Get ad percentile ranking data within the industry\n- Understand ad performance levels relative to peers across various metrics\n- Help evaluate ad effectiveness and develop optimization strategies\n\n### Parameters\n- material_id: Ad material ID, required parameter\n- metric: Analysis metric, options:\n - ctr_percentile: CTR percentile (default)\n - time_attr_conversion_rate_percentile: Time-attributed conversion rate percentile\n - click_cnt_percentile: Click count percentile\n - time_attr_convert_cnt_percentile: Time-attributed conversion count percentile\n - show_cnt_percentile: Impression count percentile\n- period_type: Time period in days, default 180\n- cookie: Custom Cookie string, optional parameter, can be used to fetch more data\n\n### Return Description\n- `percentile_data`: Percentile data\n - `ctr_percentile`: Click-through rate percentile (0-100)\n - `cvr_percentile`: Conversion rate percentile\n - `engagement_percentile`: Engagement rate percentile\n - `view_percentile`: View count percentile\n - `industry_average`: Industry average comparison\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_tiktok_ads_get_ad_percentile", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return Description\n- `percentile_data`: Percentile data\n - `ctr_percentile`: Click-through rate percentile (0-100)\n - `cvr_percentile`: Conversion rate percentile\n - `engagement_percentile`: Engagement rate percentile\n - `view_percentile`: View count percentile\n - `industry_average`: Industry average comparison\n\nThe media-type example is an illustrative response from the official documentation, not a live response. Its router and params metadata use upstream naming.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" }, "example": { "code": 200, "router": "/api/v1/tiktok/ads/get_ad_percentile", "params": { "material_id": "7213258221116751874" }, "data": { "percentile_data": { "ctr_percentile": 85, "cvr_percentile": 72, "engagement_percentile": 90, "view_percentile": 88, "industry_average": { "ctr": 2.5, "cvr": 1.2, "engagement": 5.8 } } } } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok get_ad_percentile", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "7c1b4e6fa08c" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/ads/get_ad_percentile", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_tiktok_ads_get_ad_percentile", "method": "POST", "path": "/apis/v1/tikhub/tiktok/ads/get_ad_percentile" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "material_id": { "type": "string", "title": "Material Id", "description": "Ad material ID" }, "metric": { "type": "string", "title": "Metric", "description": "Analysis metric, options:\n - ctr_percentile: CTR percentile (default)\n - time_attr_conversion_rate_percentile: Time-attributed conversion rate percentile\n - click_cnt_percentile: Click count percentile\n - time_attr_convert_cnt_percentile: Time-attributed conversion count percentile\n - show_cnt_percentile: Impression count percentile", "default": "ctr_percentile" }, "period_type": { "type": "integer", "title": "Period Type", "description": "Time period in days, default 180", "default": 180 }, "cookie": { "type": "string", "title": "Cookie", "description": "Custom Cookie string, optional parameter, can be used to fetch more data" } }, "type": "object", "required": [ "material_id" ], "title": "Body_get_ad_percentile_api_v1_tiktok_ads_get_ad_percentile_post" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:1af6cc7cbb07bc55494bd213b133b3091d39155470eada9f741d4b29709f39f4" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-tiktok-ads-get_ad_percentile" } }, "/apis/v1/tikhub/tiktok/ads/get_ads_detail": { "post": { "description": "TikTok (ads).\n\n### Purpose\n- Retrieve detailed information about a single TikTok ad, including creative content, creator info, and engagement data\n- Analyze ad performance metrics such as views, likes, comments, and other core statistics\n- Help advertisers and marketers gain deep insights into specific ad effectiveness and user feedback\n\n### Parameters\n- ads_id: Ad ID, required parameter, can be obtained from ad lists or TikTok Ads Creative Center\n- cookie: Custom Cookie string, optional parameter, can be used to fetch more data\n\n### Return Description\n- `ad_title`: Ad title\n- `brand_name`: Brand name\n- `comment`: Comment count\n- `cost`: Cost level (1-5)\n- `country_code`: List of target country codes\n- `ctr`: Click-through rate (percentage)\n- `favorite`: Whether favorited\n- `has_summary`: Whether has summary\n- `highlight_text`: Highlight text\n- `id`: Ad ID\n- `industry_key`: Industry label\n- `is_search`: Whether from search results\n- `keyword_list`: List of keywords\n- `landing_page`: Landing page URL\n- `like`: Like count\n- `objective_key`: Ad objective key\n- `objectives`: List of ad objectives\n - `label`: Objective label\n - `value`: Objective value\n- `pattern_label`: List of pattern labels\n- `share`: Share count\n- `source`: Source\n- `source_key`: Source key value\n- `tag`: Tag\n- `video_info`: Video information\n - `vid`: Video ID\n - `duration`: Duration (seconds)\n - `cover`: Cover image URL\n - `video_url`: Video playback URLs\n - `720p`: 720p quality video URL\n - `width`: Video width\n - `height`: Video height\n- `voice_over`: Whether has voice over\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_tiktok_ads_get_ads_detail", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return Description\n- `ad_title`: Ad title\n- `brand_name`: Brand name\n- `comment`: Comment count\n- `cost`: Cost level (1-5)\n- `country_code`: List of target country codes\n- `ctr`: Click-through rate (percentage)\n- `favorite`: Whether favorited\n- `has_summary`: Whether has summary\n- `highlight_text`: Highlight text\n- `id`: Ad ID\n- `industry_key`: Industry label\n- `is_search`: Whether from search results\n- `keyword_list`: List of keywords\n- `landing_page`: Landing page URL\n- `like`: Like count\n- `objective_key`: Ad objective key\n- `objectives`: List of ad objectives\n - `label`: Objective label\n - `value`: Objective value\n- `pattern_label`: List of pattern labels\n- `share`: Share count\n- `source`: Source\n- `source_key`: Source key value\n- `tag`: Tag\n- `video_info`: Video information\n - `vid`: Video ID\n - `duration`: Duration (seconds)\n - `cover`: Cover image URL\n - `video_url`: Video playback URLs\n - `720p`: 720p quality video URL\n - `width`: Video width\n - `height`: Video height\n- `voice_over`: Whether has voice over\n\nThe media-type example is an illustrative response from the official documentation, not a live response. Its router and params metadata use upstream naming.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" }, "example": { "code": 200, "router": "/api/v1/tiktok/ads/get_ads_detail", "params": { "ads_id": "7131673574381518849" }, "data": { "code": 0, "msg": "OK", "data": { "ad_title": "BLACK FRIDAY SALE at 50% OFF + FREE SHIPPING", "brand_name": "The Bamboo Breeze Shop", "comment": 232, "cost": 2, "country_code": [ "US", "CA", "PH", "SE", "FI" ], "ctr": 0.14, "favorite": false, "has_summary": true, "highlight_text": "", "id": "7131673574381518849", "industry_key": "label_29100000000", "is_search": false, "keyword_list": [ "adjustable back posture corrector", "poor posture", "eliminate unnecessary back pain" ], "landing_page": "https://thebamboobreezeshop.com/products/adjustable-back-shoulder-posture-corrector", "like": 61242, "objective_key": "campaign_objective_conversion", "objectives": [ { "label": "campaign_objective_conversion", "value": 3 }, { "label": "campaign_objective_product_sales", "value": 15 } ], "pattern_label": [], "share": 6486, "source": "TikTok Ads Manager", "source_key": 1, "tag": 3, "video_info": { "vid": "v12025gd0000cuavia7og65o5g7ucnb0", "duration": 17, "cover": "https://p16-sign-va.tiktokcdn.com/xxx", "video_url": { "720p": "https://v16m-default.tiktokcdn.com/xxx" }, "width": 576, "height": 1024 }, "voice_over": true } } } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok get_ads_detail", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "fd2accd57e5c" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/ads/get_ads_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_tiktok_ads_get_ads_detail", "method": "POST", "path": "/apis/v1/tikhub/tiktok/ads/get_ads_detail" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "ads_id": { "type": "string", "title": "Ads Id", "description": "Ad ID, required parameter, can be obtained from ad lists or TikTok Ads Creative Center" }, "cookie": { "type": "string", "title": "Cookie", "description": "Custom Cookie string, optional parameter, can be used to fetch more data" } }, "type": "object", "required": [ "ads_id" ], "title": "Body_get_ads_detail_api_v1_tiktok_ads_get_ads_detail_post" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:7999bb77447afb435b8b6d799904be1b6b7674cbb6be001940a20ac03af181b7" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-tiktok-ads-get_ads_detail" } }, "/apis/v1/tikhub/tiktok/ads/get_configure_safety": { "post": { "description": "TikTok (ads).\n\n### Purpose\n- Get the safety/availability config switches of TikTok Creative Center search modules\n- Check whether top ads, keyword, hashtag, sound, creator searches are currently available\n\n### Parameters\n- Root JSON body: Custom Cookie string, optional parameter, you can use your own Cookie to get more data\n\n### Return Description\n- `top_ads_search`: Top ads search switch (0/1)\n- `keyword_search`: Keyword search switch (0/1)\n- `hashtag_search`: Hashtag search switch (0/1)\n- `sound_search`: Sound search switch (0/1)\n- `creator_search`: Creator search switch (0/1)\n- `cc_banner_key`: Banner config key\n\n### Request body\nSend the cookie value as a JSON string at the root of the request body.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_tiktok_ads_get_configure_safety", "responses": { "200": { "description": "Successful Response\n\n### Return Description\n- `top_ads_search`: Top ads search switch (0/1)\n- `keyword_search`: Keyword search switch (0/1)\n- `hashtag_search`: Hashtag search switch (0/1)\n- `sound_search`: Sound search switch (0/1)\n- `creator_search`: Creator search switch (0/1)\n- `cc_banner_key`: Banner config key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok get_configure_safety", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "8bc68c190175" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/ads/get_configure_safety", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_tiktok_ads_get_configure_safety", "method": "POST", "path": "/apis/v1/tikhub/tiktok/ads/get_configure_safety" }, "requestBody": { "content": { "application/json": { "schema": { "type": "string", "title": "Cookie", "description": "Custom Cookie string (optional) Send the cookie value as a JSON string at the root of the request body." } } } }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:3d806da2964c35b0c41c23acfadfba2364a685fa9d682e2e079750273c76acef" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-tiktok-ads-get_configure_safety" } }, "/apis/v1/tikhub/tiktok/ads/get_creators_card": { "post": { "description": "TikTok (ads).\n\n### Purpose\n- Batch fetch creator cards including audience profile, follower growth, overall performance and recent posts\n- Pairs with the Top Contents ranking to analyze the creators behind trending videos\n\n### Parameters\n- tt_uids: Creator ID list, obtained from `itemInfo.creatorID` of /tikhub/tiktok/ads/get_top_contents_list, multiple IDs allowed\n- need_loader_list: Data module IDs to return, omit for all. Options:\n - `101`: Creator basic info\n - `102`: Quote and price index\n - `103`: Creator basic info\n - `104`: Statistics (audience profile / follower trend / overall performance / video performance)\n - `105`: Recent posts\n - `106`: Creator marketplace status\n - `107`: Content labels\n - `125`: Creator type and display info\n- creator_type: Creator type, default 2\n- cookie: Custom Cookie string, optional parameter, you can use your own Cookie to get more data\n\n### Request Example\n```json\n{\n \"tt_uids\": [\"103641138313531392\"],\n \"need_loader_list\": [101, 104, 105],\n \"creator_type\": 2\n}\n```\n\n### Return Description\n- `creators`: Creator card list; returned fields depend on need_loader_list\n (ttUID / creatorTTInfo / statisticData / recentItems / contentLabels / creatorProfile / priceIndex / esData)\n\nAPI references: `get_top_contents_list` = `POST /tikhub/tiktok/ads/get_top_contents_list` (operationId: `post_tikhub_tiktok_ads_get_top_contents_list`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_tiktok_ads_get_creators_card", "responses": { "200": { "description": "Successful Response\n\n### Return Description\n- `creators`: Creator card list; returned fields depend on need_loader_list\n (ttUID / creatorTTInfo / statisticData / recentItems / contentLabels / creatorProfile / priceIndex / esData)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok get_creators_card", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "4e5c61730835" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/ads/get_creators_card", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_tiktok_ads_get_creators_card", "method": "POST", "path": "/apis/v1/tikhub/tiktok/ads/get_creators_card" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "tt_uids": { "items": { "type": "string" }, "type": "array", "title": "Tt Uids", "description": "Creator ID list, obtained from `itemInfo.creatorID` of /tikhub/tiktok/ads/get_top_contents_list, multiple IDs allowed\n\nAPI references: `get_top_contents_list` = `POST /tikhub/tiktok/ads/get_top_contents_list` (operationId: `post_tikhub_tiktok_ads_get_top_contents_list`).", "default": [ "103641138313531392" ] }, "need_loader_list": { "items": { "type": "integer" }, "type": "array", "title": "Need Loader List", "description": "Data module IDs, empty for all\n\nUsage: Data module IDs to return, omit for all. Options:\n - `101`: Creator basic info\n - `102`: Quote and price index\n - `103`: Creator basic info\n - `104`: Statistics (audience profile / follower trend / overall performance / video performance)\n - `105`: Recent posts\n - `106`: Creator marketplace status\n - `107`: Content labels\n - `125`: Creator type and display info", "example": [ 101, 102, 103, 104, 105, 106, 107, 125 ] }, "creator_type": { "type": "integer", "title": "Creator Type", "description": "Creator type, default 2", "default": 2 }, "cookie": { "type": "string", "title": "Cookie", "description": "Custom Cookie string, optional parameter, you can use your own Cookie to get more data" } }, "type": "object", "title": "Body_get_creators_card_api_v1_tiktok_ads_get_creators_card_post" } } } }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:9f487185cdca97529ead43c90da2fe605cc5b57a68d3cf996bbdc936bb1007d1" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-tiktok-ads-get_creators_card" } }, "/apis/v1/tikhub/tiktok/ads/get_location_list": { "post": { "description": "TikTok (ads).\n\n### Purpose\n- Get the list of countries/regions supported by TikTok Creative Center\n- Useful as a reference for the country_code parameter of other endpoints\n\n### Parameters\n- Root JSON body: Custom Cookie string, optional parameter, you can use your own Cookie to get more data\n\n### Return Description\n- `country`: Country/region list, each item contains:\n - `id`: Country/region code (e.g. US, JP)\n - `value`: Country/region name (e.g. United States)\n - `label`: Display label\n\n### Request body\nSend the cookie value as a JSON string at the root of the request body.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_tiktok_ads_get_location_list", "responses": { "200": { "description": "Successful Response\n\n### Return Description\n- `country`: Country/region list, each item contains:\n - `id`: Country/region code (e.g. US, JP)\n - `value`: Country/region name (e.g. United States)\n - `label`: Display label", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok get_location_list", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "fecef89523f2" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/ads/get_location_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_tiktok_ads_get_location_list", "method": "POST", "path": "/apis/v1/tikhub/tiktok/ads/get_location_list" }, "requestBody": { "content": { "application/json": { "schema": { "type": "string", "title": "Cookie", "description": "Custom Cookie string (optional) Send the cookie value as a JSON string at the root of the request body." } } } }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e89277465bbbba860c143b9f07af1c15e0d98ed4bf6cb2130e8ee3f1981c8388" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-tiktok-ads-get_location_list" } }, "/apis/v1/tikhub/tiktok/ads/get_query_suggestions": { "post": { "description": "TikTok (ads).\n\n### Purpose\n- Get popular query suggestions for ad search\n- Understand current popular ad search keywords and trends\n- Help discover new creative directions and hot topics\n\n### Parameters\n- query: Leave empty for popular suggestions in scenario 1; provide a keyword for related suggestions in scenario 2\n- count: Number of suggestions to return, default 50\n- scenario: Scenario type: 1 for popular suggestions, 2 for related suggestions\n- country_code: Optional country code\n- cookie: Custom Cookie string, optional parameter, can be used to fetch more data\n\n### Note\n- If you've applied one or more filters and there's no result returned, try adjusting or removing some of them. The TikTok Creator dataset only includes a selection of popular records and may not contain the complete set of data.\n\n### Return Description\n- `query`: Query suggestions list (string array)\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_tiktok_ads_get_query_suggestions", "responses": { "200": { "description": "Successful Response\n\n### Return Description\n- `query`: Query suggestions list (string array)\n\nThe media-type example is an illustrative response from the official documentation, not a live response. Its router and params metadata use upstream naming.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" }, "example": { "code": 200, "router": "/api/v1/tiktok/ads/get_query_suggestions", "params": { "count": "50", "scenario": "1" }, "data": { "code": 0, "msg": "OK", "data": { "query": [ "shop now", "50% off" ] } } } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok get_query_suggestions", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a1b6f9eb300c" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/ads/get_query_suggestions", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_tiktok_ads_get_query_suggestions", "method": "POST", "path": "/apis/v1/tikhub/tiktok/ads/get_query_suggestions" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "query": { "type": "string", "title": "Query", "description": "Leave empty for scenario 1 (popular suggestions); input a keyword for scenario 2\n\nUsage: Leave empty for popular suggestions in scenario 1; provide a keyword for related suggestions in scenario 2" }, "count": { "type": "integer", "title": "Count", "description": "Suggestion count\n\nUsage: Number of suggestions to return, default 50", "default": 50 }, "scenario": { "type": "integer", "title": "Scenario", "description": "Scene type: 1=Popular suggestions, 2=Related keyword suggestions", "default": 1 }, "country_code": { "type": "string", "title": "Country Code", "description": "Optional country/region code" }, "cookie": { "type": "string", "title": "Cookie", "description": "Custom Cookie string, optional parameter, can be used to fetch more data" } }, "type": "object", "title": "Body_get_query_suggestions_api_v1_tiktok_ads_get_query_suggestions_post" } } } }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:2b72dcf53bab030b2b3bbddb69847804093e8d0b242a339bb44b801db724c37b" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-tiktok-ads-get_query_suggestions" } }, "/apis/v1/tikhub/tiktok/ads/get_recommended_ads": { "post": { "description": "TikTok (ads).\n\n### Purpose\n- Get similar recommended ads based on a specified ad\n- Discover excellent ad cases in the same industry or with similar styles\n- Provide more references and inspiration for ad creativity\n\n### Parameters\n- material_id: Reference ad material ID, required parameter\n- industry: Industry ID, e.g., Games: 25308000000\n- country_code: Country code, e.g., US, UK, JP\n- cookie: Custom Cookie string, optional parameter, can be used to fetch more data\n\n### Note\n- If you've applied one or more filters and there's no result returned, try adjusting or removing some of them. The TikTok Creator dataset only includes a selection of popular records and may not contain the complete set of data.\n\n### Return Description\n- `materials`: Recommended ad materials list\n - `ad_title`: Ad title\n - `brand_name`: Brand name\n - `cost`: Cost level\n - `ctr`: Click-through rate\n - `favorite`: Whether favorited\n - `id`: Ad ID\n - `industry_key`: Industry key\n - `is_search`: Whether search result\n - `like`: Like count\n - `objective_key`: Ad objective key\n - `tag`: Tag\n - `video_info`: Video information\n - `vid`: Video ID\n - `duration`: Duration in seconds\n - `cover`: Cover image URL\n - `video_url`: Video playback URLs\n - `360p`: 360p quality\n - `480p`: 480p quality\n - `540p`: 540p quality\n - `720p`: 720p quality\n - `width`: Video width\n - `height`: Video height\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_tiktok_ads_get_recommended_ads", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return Description\n- `materials`: Recommended ad materials list\n - `ad_title`: Ad title\n - `brand_name`: Brand name\n - `cost`: Cost level\n - `ctr`: Click-through rate\n - `favorite`: Whether favorited\n - `id`: Ad ID\n - `industry_key`: Industry key\n - `is_search`: Whether search result\n - `like`: Like count\n - `objective_key`: Ad objective key\n - `tag`: Tag\n - `video_info`: Video information\n - `vid`: Video ID\n - `duration`: Duration in seconds\n - `cover`: Cover image URL\n - `video_url`: Video playback URLs\n - `360p`: 360p quality\n - `480p`: 480p quality\n - `540p`: 540p quality\n - `720p`: 720p quality\n - `width`: Video width\n - `height`: Video height\n\nThe media-type example is an illustrative response from the official documentation, not a live response. Its router and params metadata use upstream naming.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" }, "example": { "code": 200, "router": "/api/v1/tiktok/ads/get_recommended_ads", "params": { "material_id": "7213258221116751874", "industry": "25308000000", "country_code": "US" }, "data": { "code": 0, "msg": "OK", "data": { "materials": [ { "ad_title": "What will you decide?", "brand_name": "Eatventure", "cost": 2, "ctr": 0.07, "favorite": false, "id": "7164756134804979714", "industry_key": "label_25308000000", "is_search": false, "like": 1009024, "objective_key": "campaign_objective_conversion", "tag": 3, "video_info": { "vid": "v10033g50000ctgjtl7og65ivnpdo87g", "duration": 30.016, "cover": "https://p16-sign-sg.tiktokcdn.com/v0201/ogKcNlWrjIQwDVBDpBbeR7PDQXnAIeA9Dgbb4w~tplv-noop.image", "video_url": { "360p": "https://v16m-default.tiktokcdn.com/9e086e91176219d756e9c875fb739dc4/684d7e29/video/tos/useast2a/tos-useast2a-ve-0051c799-euttp/oIQcoRBNNpXbALnjIeLgbKfwWPDDDDIgQ9l6BF", "480p": "https://v16m-default.tiktokcdn.com/2f304931bd351dad0e43e9771364bd78/684d7e29/video/tos/useast2a/tos-useast2a-ve-0051c799-euttp/o8lIsnPILWelBwDbDgDuwQj9UlNebAYdDUXBKS", "540p": "https://v16m-default.tiktokcdn.com/351ae3acb3121d42db8a5091811b2340/684d7e29/video/tos/useast2a/tos-useast2a-ve-0051c799-euttp/oQwpeXyWjDBg7KXcBDeDgPnDDbANoISoQIb9Ql", "720p": "https://v16m-default.tiktokcdn.com/a04bacceb906e5336a68158479f5eac5/684d7e29/video/tos/useast2a/tos-useast2a-ve-0051c799-euttp/oQQnWCmCDfpgIxegjrKAXZlbIPDNBDDbZQBHw9" }, "width": 720, "height": 1280 } } ] } } } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok get_recommended_ads", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "d5f8ed03fe32" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/ads/get_recommended_ads", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_tiktok_ads_get_recommended_ads", "method": "POST", "path": "/apis/v1/tikhub/tiktok/ads/get_recommended_ads" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "material_id": { "type": "string", "title": "Material Id", "description": "Reference ad material ID, required parameter" }, "industry": { "type": "string", "title": "Industry", "description": "Industry ID, e.g., Games: 25308000000", "default": "25308000000" }, "country_code": { "type": "string", "title": "Country Code", "description": "Country code", "default": "US" }, "cookie": { "type": "string", "title": "Cookie", "description": "Custom Cookie string, optional parameter, can be used to fetch more data" } }, "type": "object", "required": [ "material_id" ], "title": "Body_get_recommended_ads_api_v1_tiktok_ads_get_recommended_ads_post" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:87a861f789285b14d4e3c56056bf451d32d96f05f029300a50e2ebc8eddc859f" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-tiktok-ads-get_recommended_ads" } }, "/apis/v1/tikhub/tiktok/ads/get_top_ads_filters": { "post": { "description": "TikTok (ads).\n\nGet the countries, industries, objectives, languages, periods, and creative\nlabels supported by Top Ads search.\n\n### Request body\nSend the cookie value as a JSON string at the root of the request body.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_tiktok_ads_get_top_ads_filters", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok get_top_ads_filters", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "fcc923b705cb" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/ads/get_top_ads_filters", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_tiktok_ads_get_top_ads_filters", "method": "POST", "path": "/apis/v1/tikhub/tiktok/ads/get_top_ads_filters" }, "requestBody": { "content": { "application/json": { "schema": { "type": "string", "title": "Cookie", "description": "Custom Cookie string (optional) Send the cookie value as a JSON string at the root of the request body." } } } }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e56c0f64759022cecb5502df30fd08faeb446c6d3a60cfc5fa77fb25dd390b27" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-tiktok-ads-get_top_ads_filters" } }, "/apis/v1/tikhub/tiktok/ads/get_top_ads_spotlight": { "post": { "description": "TikTok (ads).\n\n### Purpose\n- Get top ads spotlight for specific industries, showcasing the most popular ad cases\n- Analyze creative trends and excellent cases within the industry\n- Provide inspiration and reference for ad creative production\n\n### Parameters\n- industry: Industry ID, optional, returns cross-industry list if omitted, e.g., Education: 25000000000\n- page: Page number, default 1\n- limit: Items per page, default 20\n- cookie: Custom Cookie string, optional parameter, can be used to fetch more data\n\n### Note\n- If you've applied one or more filters and there's no result returned, try adjusting or removing some of them. The TikTok Creator dataset only includes a selection of popular records and may not contain the complete set of data.\n\n### Return Description\n- `materials`: Ad materials list\n - `cost`: Cost level\n - `ctr`: Click-through rate\n - `highlight`: Highlight description\n - `id`: Ad ID\n - `like`: Like count\n - `video_info`: Video information\n - `vid`: Video ID\n - `duration`: Duration in seconds\n - `cover`: Cover image URL\n - `video_url`: Video playback URLs in multiple qualities\n - `360p`: 360p quality video URL\n - `480p`: 480p quality video URL\n - `540p`: 540p quality video URL\n - `720p`: 720p quality video URL\n - `width`: Video width\n - `height`: Video height\n- `pagination`: Pagination info\n - `page`: Current page\n - `size`: Items per page\n - `total`: Total count\n - `has_more`: Whether there are more items\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_tiktok_ads_get_top_ads_spotlight", "responses": { "200": { "description": "Successful Response\n\n### Return Description\n- `materials`: Ad materials list\n - `cost`: Cost level\n - `ctr`: Click-through rate\n - `highlight`: Highlight description\n - `id`: Ad ID\n - `like`: Like count\n - `video_info`: Video information\n - `vid`: Video ID\n - `duration`: Duration in seconds\n - `cover`: Cover image URL\n - `video_url`: Video playback URLs in multiple qualities\n - `360p`: 360p quality video URL\n - `480p`: 480p quality video URL\n - `540p`: 540p quality video URL\n - `720p`: 720p quality video URL\n - `width`: Video width\n - `height`: Video height\n- `pagination`: Pagination info\n - `page`: Current page\n - `size`: Items per page\n - `total`: Total count\n - `has_more`: Whether there are more items", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok get_top_ads_spotlight", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "ffa58273ca6f" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/ads/get_top_ads_spotlight", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_tiktok_ads_get_top_ads_spotlight", "method": "POST", "path": "/apis/v1/tikhub/tiktok/ads/get_top_ads_spotlight" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "industry": { "type": "string", "title": "Industry", "description": "Industry ID, optional, returns cross-industry list if omitted, e.g., Education: 25000000000" }, "page": { "type": "integer", "title": "Page", "description": "Page number, default 1", "default": 1 }, "limit": { "type": "integer", "title": "Limit", "description": "Items per page, default 20", "default": 20 }, "cookie": { "type": "string", "title": "Cookie", "description": "Custom Cookie string, optional parameter, can be used to fetch more data" } }, "type": "object", "title": "Body_get_top_ads_spotlight_api_v1_tiktok_ads_get_top_ads_spotlight_post" } } } }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:966ce6d3a842dfe9cda0c22a2e1f0278478f778a872805563feabdf0c0a34c6f" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-tiktok-ads-get_top_ads_spotlight" } }, "/apis/v1/tikhub/tiktok/ads/get_top_contents_item_detail": { "post": { "description": "TikTok (ads).\n\n### Purpose\n- Get detailed data of a single video from the Top Contents ranking\n- Returns top comments and author profile on top of the ranking data\n\n### Parameters\n- item_id: Video ID, obtained from `itemInfo.itemID` of /tikhub/tiktok/ads/get_top_contents_list\n- period_end_timestamp: Period end timestamp in seconds, required\n - Generate this value from the target ranking date; it is not returned by another endpoint\n - Example: `1785024000`; do not pass `0`, which returns an empty result\n - For period_dimension 1, pass a Sunday 00:00 UTC timestamp; other dates return no data\n - For period_dimension 3 or 5, any past date works\n - If item_id comes from /tikhub/tiktok/ads/get_top_contents_list, reuse that ranking query's timestamp\n- period_dimension: Period, one of 1 / 3 / 5, default 3, recommended to match the ranking query\n- country_code: Country code of the ranking the video belongs to, default US\n- cookie: Custom Cookie string, optional parameter, you can use your own Cookie to get more data\n\n### Note\n- Prefer passing the same country_code used for the ranking query, e.g. `TH` for a video taken from the TH ranking, to avoid an extra lookup\n\n### Return Description\n- `entityInfo`: Video detail (itemInfo / itemMetrics / itemAuthorInfo / itemAuthorMetrics / contentTags / commentInfos)\n\nAPI references: `get_top_contents_list` = `POST /tikhub/tiktok/ads/get_top_contents_list` (operationId: `post_tikhub_tiktok_ads_get_top_contents_list`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_tiktok_ads_get_top_contents_item_detail", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return Description\n- `entityInfo`: Video detail (itemInfo / itemMetrics / itemAuthorInfo / itemAuthorMetrics / contentTags / commentInfos)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok get_top_contents_item_detail", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "4cd3eeae7363" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/ads/get_top_contents_item_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_tiktok_ads_get_top_contents_item_detail", "method": "POST", "path": "/apis/v1/tikhub/tiktok/ads/get_top_contents_item_detail" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "item_id": { "type": "string", "title": "Item Id", "description": "Video item ID\n\nUsage: Video ID, obtained from `itemInfo.itemID` of /tikhub/tiktok/ads/get_top_contents_list\n\nAPI references: `get_top_contents_list` = `POST /tikhub/tiktok/ads/get_top_contents_list` (operationId: `post_tikhub_tiktok_ads_get_top_contents_list`)." }, "period_end_timestamp": { "type": "integer", "title": "Period End Timestamp", "description": "The caller must generate this 10-digit Unix timestamp in seconds from the target ranking date, for example 1785024000; do not pass 0 because it returns an empty result\n\nUsage: Period end timestamp in seconds, required\n - Generate this value from the target ranking date; it is not returned by another endpoint\n - Example: `1785024000`; do not pass `0`, which returns an empty result\n - For period_dimension 1, pass a Sunday 00:00 UTC timestamp; other dates return no data\n - For period_dimension 3 or 5, any past date works\n - If item_id comes from /tikhub/tiktok/ads/get_top_contents_list, reuse that ranking query's timestamp\n\nAPI references: `get_top_contents_list` = `POST /tikhub/tiktok/ads/get_top_contents_list` (operationId: `post_tikhub_tiktok_ads_get_top_contents_list`).", "example": 1785024000 }, "period_dimension": { "type": "integer", "title": "Period Dimension", "description": "Period dimension: 1/3/5\n\nUsage: Period, one of 1 / 3 / 5, default 3, recommended to match the ranking query", "default": 3, "example": 1 }, "country_code": { "type": "string", "title": "Country Code", "description": "Country code of the ranking the video belongs to, default US", "default": "US" }, "cookie": { "type": "string", "title": "Cookie", "description": "Custom Cookie string, optional parameter, you can use your own Cookie to get more data" } }, "type": "object", "required": [ "item_id", "period_end_timestamp" ], "title": "Body_get_top_contents_item_detail_api_v1_tiktok_ads_get_top_contents_item_detail_post" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:97a2fce49ff43c8eed7c882b43b42a3cf6f11210529a6cf3c487f81315d5e7e4" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-tiktok-ads-get_top_contents_item_detail" } }, "/apis/v1/tikhub/tiktok/ads/get_top_contents_list": { "post": { "description": "TikTok (ads).\n\n### Purpose\n- Get the Top Contents ranking from TikTok Creative Center, which always contains 100 trending videos\n- Filter by content category and sort by views / engagement rate / 6-second view rate for creative research\n\n### Parameters\n- period_end_timestamp: Period end timestamp in seconds, required\n - Generate this value from the target ranking date; it is not returned by another endpoint\n - Example: `1785024000`; do not pass `0`, which returns an empty result\n - For period_dimension 1, pass a Sunday 00:00 UTC timestamp; other dates return no data\n - For period_dimension 3 or 5, any past date works\n- period_dimension: Period, default 3\n - `1`: Weekly ranking\n - `3`: Daily ranking\n - `5`: Long-period ranking (covers videos over a longer time span)\n- country_code: Country code, default US, see /tikhub/tiktok/ads/get_location_list for options\n- content_label_ids: Content label IDs, comma separated (e.g. `11002,11015`), empty for all. Options:\n - `11001`: Nature & Animals\n - `11002`: Beauty & Care\n - `11003`: Fashion\n - `11004`: Music & Entertainment\n - `11005`: Games\n - `11006`: Education & Work\n - `11007`: Sports & Outdoor\n - `11008`: Creativity & Talent\n - `11009`: Family & Relationship\n - `11010`: Food & Beverage\n - `11011`: Vlog & Selfie\n - `11012`: Society\n - `11013`: Lifestyle & Leisure\n - `11014`: Vehicles & Transportation\n - `11015`: Technology & Finance\n- order_by_metric: Sorting metric, default 1\n - `1`: By video views\n - `2`: By engagement rate\n - `3`: By 6-second view-through rate\n- organic_only: Only include organic content, default False\n- page: Page number, default 1\n- limit: Items per page, default 20, max 100\n- cookie: Custom Cookie string, optional parameter, you can use your own Cookie to get more data\n\n### Note\n- The ranking always holds 100 items; an out-of-range page returns error code 38014001\n- The ranking covers only some countries/regions; uncovered ones return an empty `entityInfos`\n (a normal response, not a parameter error). As of 2026-08, `US` / `TH` / `JP` / `ID` / `VN`\n return data; the actual coverage follows upstream\n- Pass the same country_code to /tikhub/tiktok/ads/get_top_contents_item_detail when querying a video from the ranking\n\n### Return Description\n- `entityInfos`: Video list (itemInfo / itemMetrics / itemAuthorInfo / itemAuthorMetrics / contentTags)\n- `pagination`: Pagination info (page / limit / pageCount / totalCount / hasMore)\n\nAPI references: `get_location_list` = `POST /tikhub/tiktok/ads/get_location_list` (operationId: `post_tikhub_tiktok_ads_get_location_list`); `get_top_contents_item_detail` = `POST /tikhub/tiktok/ads/get_top_contents_item_detail` (operationId: `post_tikhub_tiktok_ads_get_top_contents_item_detail`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_tiktok_ads_get_top_contents_list", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return Description\n- `entityInfos`: Video list (itemInfo / itemMetrics / itemAuthorInfo / itemAuthorMetrics / contentTags)\n- `pagination`: Pagination info (page / limit / pageCount / totalCount / hasMore)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok get_top_contents_list", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "0bb22810febe" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/ads/get_top_contents_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_tiktok_ads_get_top_contents_list", "method": "POST", "path": "/apis/v1/tikhub/tiktok/ads/get_top_contents_list" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "period_end_timestamp": { "type": "integer", "title": "Period End Timestamp", "description": "The caller must generate this 10-digit Unix timestamp in seconds from the target ranking date, for example 1785024000; do not pass 0 because it returns an empty result\n\nUsage: Period end timestamp in seconds, required\n - Generate this value from the target ranking date; it is not returned by another endpoint\n - Example: `1785024000`; do not pass `0`, which returns an empty result\n - For period_dimension 1, pass a Sunday 00:00 UTC timestamp; other dates return no data\n - For period_dimension 3 or 5, any past date works", "example": 1785024000 }, "period_dimension": { "type": "integer", "title": "Period Dimension", "description": "Period dimension: 1/3/5\n\nUsage: Period, default 3\n - `1`: Weekly ranking\n - `3`: Daily ranking\n - `5`: Long-period ranking (covers videos over a longer time span)", "default": 3, "example": 1 }, "country_code": { "type": "string", "title": "Country Code", "description": "Country/region code\n\nUsage: Country code, default US, see /tikhub/tiktok/ads/get_location_list for options\n\nAPI references: `get_location_list` = `POST /tikhub/tiktok/ads/get_location_list` (operationId: `post_tikhub_tiktok_ads_get_location_list`).", "default": "US" }, "content_label_ids": { "type": "string", "title": "Content Label Ids", "description": "Content label IDs, comma separated (e.g. `11002,11015`), empty for all. Options:\n - `11001`: Nature & Animals\n - `11002`: Beauty & Care\n - `11003`: Fashion\n - `11004`: Music & Entertainment\n - `11005`: Games\n - `11006`: Education & Work\n - `11007`: Sports & Outdoor\n - `11008`: Creativity & Talent\n - `11009`: Family & Relationship\n - `11010`: Food & Beverage\n - `11011`: Vlog & Selfie\n - `11012`: Society\n - `11013`: Lifestyle & Leisure\n - `11014`: Vehicles & Transportation\n - `11015`: Technology & Finance", "default": "" }, "order_by_metric": { "type": "integer", "title": "Order By Metric", "description": "Order by metric: 1=Views, 2=Engagement rate, 3=6-second completion rate\n\nUsage: Sorting metric, default 1\n - `1`: By video views\n - `2`: By engagement rate\n - `3`: By 6-second view-through rate", "default": 1, "example": 1 }, "organic_only": { "type": "boolean", "title": "Organic Only", "description": "Organic content only", "default": false }, "page": { "type": "integer", "title": "Page", "description": "Page number, default 1", "default": 1 }, "limit": { "type": "integer", "title": "Limit", "description": "Items per page, default 20, max 100", "default": 20, "maximum": 100 }, "cookie": { "type": "string", "title": "Cookie", "description": "Custom Cookie string, optional parameter, you can use your own Cookie to get more data" } }, "type": "object", "required": [ "period_end_timestamp" ], "title": "Body_get_top_contents_list_api_v1_tiktok_ads_get_top_contents_list_post" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:b452d64111d3735ecedd2d93fbb189c557c7dc2304aee407cc06d23d8824f916" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/tiktok/ads/get_top_contents_list \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"period_end_timestamp\": 1785024000\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-tiktok-ads-get_top_contents_list" } }, "/apis/v1/tikhub/tiktok/ads/get_trends_hashtag_detail": { "post": { "description": "TikTok (ads).\n\n### Purpose\n- Get detailed data of a single trending hashtag from the Trends section\n- Includes popularity curve, related videos, audience age profile, representative countries\n\n### Parameters\n- hashtag_id: Hashtag ID, obtained from /tikhub/tiktok/ads/get_trends_hashtag_list\n- time_range: Time range in days, one of 7 / 30 / 90, default 90 (must match the hashtag's ranking range or data will be empty)\n- country_code: Country code, default US\n- cookie: Custom Cookie string, optional parameter, you can use your own Cookie to get more data\n\n### Note\n- If you've applied one or more filters and there's no result returned, try adjusting or removing some of them. The TikTok Creator dataset only includes a selection of popular records and may not contain the complete set of data.\n\n### Return Description\n- `hashtagName`, `publishCnt`, `vv`\n- `popularityCurve`: Popularity trend curve (timestamp / value)\n- `videoList`: Related videos (coverURL / itemID / vid / videoURL)\n- `ageProfile`: Audience age profile (ageLevel / vvPercent)\n- `representativeCountryProfile`: Representative countries (countryCode / countryTgiScore)\n- `industryIDs`: Industry IDs\n\nAPI references: `get_trends_hashtag_list` = `POST /tikhub/tiktok/ads/get_trends_hashtag_list` (operationId: `post_tikhub_tiktok_ads_get_trends_hashtag_list`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_tiktok_ads_get_trends_hashtag_detail", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return Description\n- `hashtagName`, `publishCnt`, `vv`\n- `popularityCurve`: Popularity trend curve (timestamp / value)\n- `videoList`: Related videos (coverURL / itemID / vid / videoURL)\n- `ageProfile`: Audience age profile (ageLevel / vvPercent)\n- `representativeCountryProfile`: Representative countries (countryCode / countryTgiScore)\n- `industryIDs`: Industry IDs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok get_trends_hashtag_detail", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "6cceeb02ad3f" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/ads/get_trends_hashtag_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_tiktok_ads_get_trends_hashtag_detail", "method": "POST", "path": "/apis/v1/tikhub/tiktok/ads/get_trends_hashtag_detail" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "hashtag_id": { "type": "string", "title": "Hashtag Id", "description": "Hashtag ID, obtained from /tikhub/tiktok/ads/get_trends_hashtag_list\n\nAPI references: `get_trends_hashtag_list` = `POST /tikhub/tiktok/ads/get_trends_hashtag_list` (operationId: `post_tikhub_tiktok_ads_get_trends_hashtag_list`)." }, "time_range": { "type": "integer", "title": "Time Range", "description": "Time range in days, one of 7 / 30 / 90, default 90 (must match the hashtag's ranking range or data will be empty)", "default": 90 }, "country_code": { "type": "string", "title": "Country Code", "description": "Country/region code", "default": "US" }, "cookie": { "type": "string", "title": "Cookie", "description": "Custom Cookie string, optional parameter, you can use your own Cookie to get more data" } }, "type": "object", "required": [ "hashtag_id" ], "title": "Body_get_trends_hashtag_detail_api_v1_tiktok_ads_get_trends_hashtag_detail_post" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:7c37f5f16417c4b1581327b594ec39095f7516b192ae855aa29ff56e1f2bb28a" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-tiktok-ads-get_trends_hashtag_detail" } }, "/apis/v1/tikhub/tiktok/ads/get_trends_hashtag_list": { "post": { "description": "TikTok (ads).\n\n### Purpose\n- Get the trending hashtag ranking from the Trends section of TikTok Creative Center\n- Switch by country/region to discover trending topics across markets\n\n### Parameters\n- time_range: Time range in days, one of 7 / 30 / 90, default 7\n- country_code: Country code, default US (see /tikhub/tiktok/ads/get_location_list for options)\n- page: Page number, default 1\n- limit: Items per page, default 20\n- industry_id: First-level industry ID (optional), filters hashtags by industry; omit for all industries. Options:\n - 10000000000: Education\n - 11000000000: Vehicle & Transportation\n - 12000000000: Baby, Kids & Maternity\n - 13000000000: Financial Services\n - 14000000000: Beauty & Personal Care\n - 15000000000: Tech & Electronics\n - 16000000000: Appliances\n - 17000000000: Travel\n - 18000000000: Household Products\n - 19000000000: Pets\n - 20000000000: Apps\n - 21000000000: Home Improvement\n - 22000000000: Apparel & Accessories\n - 23000000000: News & Entertainment\n - 24000000000: Business Services\n - 25000000000: Games\n - 26000000000: Life Services\n - 27000000000: Food & Beverage\n - 28000000000: Sports & Outdoor\n - 29000000000: Health\n- cookie: Custom Cookie string, optional parameter, you can use your own Cookie to get more data\n\n### Note\n- If you've applied one or more filters and there's no result returned, try adjusting or removing some of them. The TikTok Creator dataset only includes a selection of popular records and may not contain the complete set of data.\n\n### Return Description\n- `items`: Hashtag list (hashtagID / hashtagName / industryIDs / popularityCurve / publishCnt / rankIndex / topCreators / vv)\n- `pagination`: Pagination info (page / limit / totalCount / hasMore)\n\nAPI references: `get_location_list` = `POST /tikhub/tiktok/ads/get_location_list` (operationId: `post_tikhub_tiktok_ads_get_location_list`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_tiktok_ads_get_trends_hashtag_list", "responses": { "200": { "description": "Successful Response\n\n### Return Description\n- `items`: Hashtag list (hashtagID / hashtagName / industryIDs / popularityCurve / publishCnt / rankIndex / topCreators / vv)\n- `pagination`: Pagination info (page / limit / totalCount / hasMore)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok get_trends_hashtag_list", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "1fd0a10986af" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/ads/get_trends_hashtag_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_tiktok_ads_get_trends_hashtag_list", "method": "POST", "path": "/apis/v1/tikhub/tiktok/ads/get_trends_hashtag_list" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "time_range": { "type": "integer", "title": "Time Range", "description": "Time range in days, one of 7 / 30 / 90, default 7", "default": 7 }, "country_code": { "type": "string", "title": "Country Code", "description": "Country/region code\n\nUsage: Country code, default US (see /tikhub/tiktok/ads/get_location_list for options)\n\nAPI references: `get_location_list` = `POST /tikhub/tiktok/ads/get_location_list` (operationId: `post_tikhub_tiktok_ads_get_location_list`).", "default": "US" }, "page": { "type": "integer", "title": "Page", "description": "Page number, default 1", "default": 1 }, "limit": { "type": "integer", "title": "Limit", "description": "Items per page, default 20", "default": 20 }, "industry_id": { "type": "integer", "title": "Industry Id", "description": "First-level industry ID (optional), e.g. 10000000000=Education\n\nUsage: First-level industry ID (optional), filters hashtags by industry; omit for all industries. Options:\n - 10000000000: Education\n - 11000000000: Vehicle & Transportation\n - 12000000000: Baby, Kids & Maternity\n - 13000000000: Financial Services\n - 14000000000: Beauty & Personal Care\n - 15000000000: Tech & Electronics\n - 16000000000: Appliances\n - 17000000000: Travel\n - 18000000000: Household Products\n - 19000000000: Pets\n - 20000000000: Apps\n - 21000000000: Home Improvement\n - 22000000000: Apparel & Accessories\n - 23000000000: News & Entertainment\n - 24000000000: Business Services\n - 25000000000: Games\n - 26000000000: Life Services\n - 27000000000: Food & Beverage\n - 28000000000: Sports & Outdoor\n - 29000000000: Health" }, "cookie": { "type": "string", "title": "Cookie", "description": "Custom Cookie string, optional parameter, you can use your own Cookie to get more data" } }, "type": "object", "title": "Body_get_trends_hashtag_list_api_v1_tiktok_ads_get_trends_hashtag_list_post" } } } }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:44b6139a6ef3edf0df49e41957ba997efdd1fe4ae2006805ec4a92558d0bd790" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-tiktok-ads-get_trends_hashtag_list" } }, "/apis/v1/tikhub/tiktok/ads/search_ads": { "post": { "description": "TikTok (ads).\n\n### Purpose\n- Search ads in TikTok's Creative Center with multi-dimensional filtering and sorting\n- Discover effective ad cases related to specific industries, keywords, or objectives\n- Provide reference and inspiration for ad planning and creative production\n\n### Parameters\n- keyword: Search keyword, optional, returns all ads if empty\n- objective: Optional ad objective; omit it to include all objectives\n- like: Optional performance percentile; omit it to include all percentiles\n- period: Time period in days, e.g., 7, 30, 120, 180 days\n- industry: Industry ID list, multiple IDs separated by commas. Full industry ID list: https://github.com/TikHub/TikTok-Ads-Industry-Code\n- page: Page number, default 1\n- limit: Items per page, default 20, max 50\n- order_by: Sort method, \"for_you\"=Recommended, \"likes\"=Sort by likes\n- country_code: Country code, e.g., US, UK, JP\n- ad_format: Optional ad format; 1=Spark Ads, 2=Non-Spark Ads\n- ad_language: Optional ad language code, e.g., en, zh-Hant\n- duration: Optional video duration filter value\n- pattern_label: Optional creative pattern label\n- cookie: Custom Cookie string, optional parameter, can be used to fetch more data\n\n### Note\n- If you've applied one or more filters and there's no result returned, try adjusting or removing some of them. The TikTok Creator dataset only includes a selection of popular records and may not contain the complete set of data.\n\n### Common Industry ID Examples\n- Games: 27000000000\n- E-commerce: 19000000000\n- Financial Services: 30000000000\n- Education: 10000000000\n- Beauty & Personal Care: 22000000000\n- Food & Beverage: 16000000000\n\n### Return Description\n- `materials`: List of ad materials\n - `id`: Ad material ID\n - `aweme_id`: Ad video ID\n - `desc`: Ad description\n - `create_time`: Creation time\n - `video_info`: Video information\n - `cover`: Cover image URL\n - `duration`: Duration in seconds\n - `statistics`: Statistics\n - `digg_count`: Number of likes\n - `comment_count`: Number of comments\n - `share_count`: Number of shares\n - `ads_info`: Ad information\n - `advertiser_name`: Advertiser name\n - `landing_page`: Landing page URL\n- `pagination`: Pagination info\n - `page`: Current page\n - `limit`: Items per page\n - `total`: Total count\n - `has_more`: Whether there are more items\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_tiktok_ads_search_ads", "responses": { "200": { "description": "Successful Response\n\n### Return Description\n- `materials`: List of ad materials\n - `id`: Ad material ID\n - `aweme_id`: Ad video ID\n - `desc`: Ad description\n - `create_time`: Creation time\n - `video_info`: Video information\n - `cover`: Cover image URL\n - `duration`: Duration in seconds\n - `statistics`: Statistics\n - `digg_count`: Number of likes\n - `comment_count`: Number of comments\n - `share_count`: Number of shares\n - `ads_info`: Ad information\n - `advertiser_name`: Advertiser name\n - `landing_page`: Landing page URL\n- `pagination`: Pagination info\n - `page`: Current page\n - `limit`: Items per page\n - `total`: Total count\n - `has_more`: Whether there are more items\n\nThe media-type example is an illustrative response from the official documentation, not a live response. Its router and params metadata use upstream naming.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" }, "example": { "code": 200, "router": "/api/v1/tiktok/ads/search_ads", "params": { "keyword": "cat toy", "period": 180, "industry": "27000000000", "page": 1, "limit": 20 }, "data": { "materials": [ { "id": "7213258221116751874", "aweme_id": "7213258221116751874", "desc": "Best interactive cat toys! Keep your cats entertained 🐱", "create_time": 1680234567, "video_info": { "cover": "https://p16-ad-sg.tiktokcdn.com/img/xxx.jpeg", "duration": 15 }, "statistics": { "digg_count": 128456, "comment_count": 3421, "share_count": 892 }, "ads_info": { "advertiser_name": "PetToys Inc.", "landing_page": "https://example.com/cat-toys" } } ], "pagination": { "page": 1, "limit": 20, "total": 1523, "has_more": true } } } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok search_ads", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "c0caa31c719f" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/ads/search_ads", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_tiktok_ads_search_ads", "method": "POST", "path": "/apis/v1/tikhub/tiktok/ads/search_ads" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "objective": { "title": "Objective", "description": "Ad objective (optional): 1=Traffic, 2=App install, 3=Conversion, 4=Video views, 5=Reach, 6=Lead generation, 7=Product sales", "type": [ "integer", "null" ] }, "like": { "title": "Like", "description": "Performance rank (optional; 1=top 1-20%, 2=top 21-40%, 3=top 41-60%, 4=top 61-80%, 5=top 81-100%)", "type": [ "integer", "null" ] }, "period": { "type": "integer", "title": "Period", "description": "Time period in days, e.g., 7, 30, 120, 180 days", "default": 180 }, "industry": { "type": "string", "title": "Industry", "description": "Industry ID list, multiple IDs separated by commas. Full industry ID list: https://github.com/TikHub/TikTok-Ads-Industry-Code" }, "keyword": { "type": "string", "title": "Keyword", "description": "Search keyword, optional, returns all ads if empty" }, "page": { "type": "integer", "title": "Page", "description": "Page number, default 1", "default": 1 }, "limit": { "type": "integer", "title": "Limit", "description": "Items per page, default 20, max 50", "default": 20, "maximum": 50 }, "order_by": { "type": "string", "title": "Order By", "description": "Sort method, \"for_you\"=Recommended, \"likes\"=Sort by likes", "default": "for_you" }, "country_code": { "type": "string", "title": "Country Code", "description": "Country code", "default": "US" }, "ad_format": { "title": "Ad Format", "description": "Ad format (optional): 1=Spark Ads, 2=Non-Spark Ads", "type": [ "integer", "null" ] }, "ad_language": { "title": "Ad Language", "description": "Ad language (optional)", "type": [ "string", "null" ] }, "duration": { "title": "Duration", "description": "Video duration filter value (optional)", "type": [ "integer", "null" ] }, "pattern_label": { "title": "Pattern Label", "description": "Creative pattern label (optional)", "type": [ "string", "null" ] }, "search_id": { "type": "string", "title": "Search Id", "description": "Search ID (optional)" }, "cookie": { "type": "string", "title": "Cookie", "description": "Custom Cookie string, optional parameter, can be used to fetch more data" } }, "type": "object", "title": "Body_search_ads_api_v1_tiktok_ads_search_ads_post" } } } }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:7c8f8d5668d20fb2fb7a39c619eb55007d35c3774a72276f058ed7a6e889913c" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-tiktok-ads-search_ads" } }, "/apis/v1/tikhub/tiktok/analytics/detect_fake_views": { "get": { "description": "TikTok (analytics).\n\n### Purpose\n- Analyze TikTok video traffic data using advanced algorithms to precisely detect potential fake views and unnatural engagement\n- Evaluate content authenticity and traffic quality based on TikTok's Traffic Pool theory\n- Provide comprehensive fraud risk analysis with in-depth assessment across 8 dimensions and 20+ metrics\n- Deliver professional traffic quality reports and optimization recommendations for creators, MCN agencies, and content managers\n\n### Parameters\n- item_id: Video ID, required parameter, can be extracted from video URL (e.g., 7460937381265411370 from https://www.tiktok.com/@tiktok/video/7460937381265411370)\n- content_category: Content category, optional parameter, affects engagement rate benchmarks, options include:\n - default: Default category for general content\n - entertainment: Entertainment content, expected to have higher engagement\n - education: Educational content, expected to have moderate engagement and higher save rates\n - product: Product content, expected to have lower engagement but higher conversion\n - verified_large: Large verified accounts, expected to have appropriately lower engagement rates\n\n### Return Description\n- `video_metrics`: Core video metrics\n - `total_views`: Total number of views\n - `total_likes`: Total number of likes\n - `total_comments`: Total number of comments\n - `total_favorites`: Total number of saves\n - `total_shares`: Total number of shares\n - `engagement_rates`: Engagement rate metrics, higher is better\n - `like_ratio`: Like rate, normal range 1-10%, may be lower for large accounts\n - `comment_ratio`: Comment rate, normal range 0.1-0.5%, excellent if above 1%\n - `favorite_ratio`: Save rate, normal range 0.05-0.8%\n - `share_ratio`: Share rate, normal range 0.05-0.5%, excellent if above 1%\n\n- `creator_metrics`: Creator account health indicators\n - `account_age_days`: Account age in days, longer is more credible\n - `follower_count`: Number of followers, affects expected view count\n - `verified`: Whether account is verified, verified accounts have higher credibility\n - `trust_score`: Account trust score (0-100), higher is more trustworthy\n\n- `content_metrics`: Content quality indicators\n - `content_type`: Content type (video, image, etc.)\n - `created_by_ai`: Whether AI-generated, AI-generated content may have specific traffic patterns\n - `high_quality_upload`: Whether high-quality upload, high-quality uploads are more credible\n\n- `fake_view_analysis`: Comprehensive fake traffic analysis\n - `fake_score`: Fake view score (0-100), lower is better:\n - 0-20: Very low risk, natural traffic patterns\n - 20-40: Low risk, may have minor anomalies but not problematic\n - 40-60: Medium risk, anomalies worth attention\n - 60-80: High risk, obvious fake traffic characteristics\n - 80-100: Very high risk, almost certainly fake traffic\n - `confidence_level`: Risk level, categorized as \"Minimal\", \"Low\", \"Medium\", \"High\"\n - `estimated_fake_views`: Estimated fake views, calculated based on fake traffic model\n - `fake_view_percentage`: Fake view percentage, proportion of fake views to total views\n - `is_suspicious`: Whether suspicious, comprehensive judgment if attention is needed\n - `main_detection_reason`: Main detection reason, most significant anomaly feature\n - `component_scores`: Dimensional anomaly scores, each 0-100, lower is better:\n - `engagement_score`: Engagement anomaly score\n - `distribution_score`: Distribution anomaly score\n - `consistency_score`: Consistency anomaly score\n - `creator_credibility_score`: Creator credibility anomaly score\n - `content_authenticity_score`: Content authenticity anomaly score\n - `follower_correlation_score`: Follower correlation anomaly score\n - `racing_mechanism_score`: Racing mechanism anomaly score\n - `fan_growth_score`: Fan growth anomaly score\n\n- `traffic_pool`: Traffic pool analysis (TikTok racing mechanism)\n - `current_tier`: Current traffic pool level (1-8), higher means more traffic\n - `current_tier_name`: Current traffic pool name\n - `expected_tier`: Expected traffic pool level, based on organic traffic prediction\n - `expected_tier_name`: Expected traffic pool name\n - `current_views_range`: Current traffic pool expected view range\n - `expected_views_range`: Expected traffic pool view range\n - `estimated_organic_views`: Estimated organic views, real views after deducting fake ones\n\n- `suspicious_features`: List of suspicious features, specific detected anomalies\n\n- `recommendations`: Recommended actions\n - `action`: Recommended action type, possible values include:\n - `no_action`: No action needed, healthy content\n - `monitor`: Continuous monitoring, minor anomalies present\n - `scheduled_review`: Schedule review, anomalies worth attention\n - `immediate_review`: Immediate review, serious anomalies present\n - `risk_level`: Risk level (\"low\", \"medium\", \"high\", \"critical\")\n - `potential_revenue_impact`: Potential revenue impact\n - `suggested_steps`: Suggested steps, specific action recommendations\n\n- `mcn_report`: (Optional) MCN business impact analysis report, applicable for business accounts\n - `summary`: Summary information\n - `business_impact`: Business impact assessment\n - `revenue_impact`: Revenue impact assessment\n - `brand_safety_impact`: Brand safety impact\n - `platform_relationship`: Platform relationship impact\n - `contract_impact`: Contract impact assessment\n - `recommended_actions`: Recommended action list\n - `historical_context`: Historical background data\n\n### Features and Advantages\n- Precise evaluation system built on TikTok's native Traffic Pool theory\n- Comprehensive analysis across 8 dimensions and 20+ metrics, covering traffic, engagement, creator, content, etc.\n- Adaptive algorithm automatically adjusts thresholds based on account size, verification status, content type\n- Anomaly detection based on big data statistical models, accurately identifies unnatural traffic patterns\n- Provides customized evaluation standards for different account sizes (micro, small, medium, large, extra-large)\n- Delivers detailed business impact analysis and specific, actionable recommendations\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_analytics_detect_fake_views", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return Description\n- `video_metrics`: Core video metrics\n - `total_views`: Total number of views\n - `total_likes`: Total number of likes\n - `total_comments`: Total number of comments\n - `total_favorites`: Total number of saves\n - `total_shares`: Total number of shares\n - `engagement_rates`: Engagement rate metrics, higher is better\n - `like_ratio`: Like rate, normal range 1-10%, may be lower for large accounts\n - `comment_ratio`: Comment rate, normal range 0.1-0.5%, excellent if above 1%\n - `favorite_ratio`: Save rate, normal range 0.05-0.8%\n - `share_ratio`: Share rate, normal range 0.05-0.5%, excellent if above 1%\n\n- `creator_metrics`: Creator account health indicators\n - `account_age_days`: Account age in days, longer is more credible\n - `follower_count`: Number of followers, affects expected view count\n - `verified`: Whether account is verified, verified accounts have higher credibility\n - `trust_score`: Account trust score (0-100), higher is more trustworthy\n\n- `content_metrics`: Content quality indicators\n - `content_type`: Content type (video, image, etc.)\n - `created_by_ai`: Whether AI-generated, AI-generated content may have specific traffic patterns\n - `high_quality_upload`: Whether high-quality upload, high-quality uploads are more credible\n\n- `fake_view_analysis`: Comprehensive fake traffic analysis\n - `fake_score`: Fake view score (0-100), lower is better:\n - 0-20: Very low risk, natural traffic patterns\n - 20-40: Low risk, may have minor anomalies but not problematic\n - 40-60: Medium risk, anomalies worth attention\n - 60-80: High risk, obvious fake traffic characteristics\n - 80-100: Very high risk, almost certainly fake traffic\n - `confidence_level`: Risk level, categorized as \"Minimal\", \"Low\", \"Medium\", \"High\"\n - `estimated_fake_views`: Estimated fake views, calculated based on fake traffic model\n - `fake_view_percentage`: Fake view percentage, proportion of fake views to total views\n - `is_suspicious`: Whether suspicious, comprehensive judgment if attention is needed\n - `main_detection_reason`: Main detection reason, most significant anomaly feature\n - `component_scores`: Dimensional anomaly scores, each 0-100, lower is better:\n - `engagement_score`: Engagement anomaly score\n - `distribution_score`: Distribution anomaly score\n - `consistency_score`: Consistency anomaly score\n - `creator_credibility_score`: Creator credibility anomaly score\n - `content_authenticity_score`: Content authenticity anomaly score\n - `follower_correlation_score`: Follower correlation anomaly score\n - `racing_mechanism_score`: Racing mechanism anomaly score\n - `fan_growth_score`: Fan growth anomaly score\n\n- `traffic_pool`: Traffic pool analysis (TikTok racing mechanism)\n - `current_tier`: Current traffic pool level (1-8), higher means more traffic\n - `current_tier_name`: Current traffic pool name\n - `expected_tier`: Expected traffic pool level, based on organic traffic prediction\n - `expected_tier_name`: Expected traffic pool name\n - `current_views_range`: Current traffic pool expected view range\n - `expected_views_range`: Expected traffic pool view range\n - `estimated_organic_views`: Estimated organic views, real views after deducting fake ones\n\n- `suspicious_features`: List of suspicious features, specific detected anomalies\n\n- `recommendations`: Recommended actions\n - `action`: Recommended action type, possible values include:\n - `no_action`: No action needed, healthy content\n - `monitor`: Continuous monitoring, minor anomalies present\n - `scheduled_review`: Schedule review, anomalies worth attention\n - `immediate_review`: Immediate review, serious anomalies present\n - `risk_level`: Risk level (\"low\", \"medium\", \"high\", \"critical\")\n - `potential_revenue_impact`: Potential revenue impact\n - `suggested_steps`: Suggested steps, specific action recommendations\n\n- `mcn_report`: (Optional) MCN business impact analysis report, applicable for business accounts\n - `summary`: Summary information\n - `business_impact`: Business impact assessment\n - `revenue_impact`: Revenue impact assessment\n - `brand_safety_impact`: Brand safety impact\n - `platform_relationship`: Platform relationship impact\n - `contract_impact`: Contract impact assessment\n - `recommended_actions`: Recommended action list\n - `historical_context`: Historical background data\n\nThe media-type example is an illustrative response from the official documentation, not a live response. Its router and params metadata use upstream naming.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" }, "example": { "code": 200, "router": "/api/v1/tiktok/analytics/detect_fake_views", "params": { "item_id": "7460937381265411370", "content_category": "verified_large" }, "data": { "video_metrics": { "total_views": 159414915, "total_likes": 15817234, "total_comments": 392493, "total_favorites": 1051470, "total_shares": 1312741, "engagement_rates": { "like_ratio": 0.09922, "comment_ratio": 0.00246, "favorite_ratio": 0.0066, "share_ratio": 0.00823 } }, "creator_metrics": { "account_age_days": 3733.94, "follower_count": 89827771, "verified": true, "trust_score": 100 }, "content_metrics": { "content_type": "video", "created_by_ai": false, "high_quality_upload": true }, "fake_view_analysis": { "fake_score": 7.16, "confidence_level": "Minimal", "estimated_fake_views": 7970745, "fake_view_percentage": 5.0, "is_suspicious": false, "main_detection_reason": "Statistical View Anomalies", "component_scores": { "engagement_score": 0.0, "distribution_score": 10.0, "consistency_score": 0, "creator_credibility_score": 0, "content_authenticity_score": 34.0, "follower_correlation_score": 35.0, "racing_mechanism_score": 0, "fan_growth_score": 45 } }, "traffic_pool": { "current_tier": 8, "current_tier_name": "8th-Level Traffic Pool", "expected_tier": 8, "expected_tier_name": "8th-Level Traffic Pool", "current_views_range": "30M+", "expected_views_range": "30M+", "estimated_organic_views": 148000807 }, "suspicious_features": [ "Suspicious: Reached 100000 followers from 10000 in only 31 days", "Suspicious: Account gaining 24063 followers per day on average" ], "recommendations": { "action": "no_action", "risk_level": "low", "potential_revenue_impact": "minimal", "suggested_steps": [ "No immediate action required", "Include in routine monitoring" ] }, "mcn_report": { "summary": { "estimated_revenue_impact": 7970.745, "recommended_actions": "No immediate action required" }, "business_impact": { "revenue_impact": { "level": "low", "estimated_amount": 7970.745 }, "brand_safety_impact": { "level": "minimal" }, "platform_relationship": { "status": "good" } } } } } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok detect_fake_views", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "3195a69e21c8" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/analytics/detect_fake_views", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_analytics_detect_fake_views", "method": "GET", "path": "/apis/v1/tikhub/tiktok/analytics/detect_fake_views" }, "parameters": [ { "name": "content_category", "in": "query", "required": false, "schema": { "type": "string", "description": "Content category, optional parameter, affects engagement rate benchmarks, options include:\n - default: Default category for general content\n - entertainment: Entertainment content, expected to have higher engagement\n - education: Educational content, expected to have moderate engagement and higher save rates\n - product: Product content, expected to have lower engagement but higher conversion\n - verified_large: Large verified accounts, expected to have appropriately lower engagement rates", "default": "default", "title": "Content Category" }, "description": "Content category, optional parameter, affects engagement rate benchmarks, options include:\n - default: Default category for general content\n - entertainment: Entertainment content, expected to have higher engagement\n - education: Educational content, expected to have moderate engagement and higher save rates\n - product: Product content, expected to have lower engagement but higher conversion\n - verified_large: Large verified accounts, expected to have appropriately lower engagement rates" }, { "name": "item_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Video ID, required parameter, can be extracted from video URL (e.g., 7460937381265411370 from https://www.tiktok.com/@tiktok/video/7460937381265411370)", "title": "Item Id" }, "description": "Video ID, required parameter, can be extracted from video URL (e.g., 7460937381265411370 from https://www.tiktok.com/@tiktok/video/7460937381265411370)", "example": "7460937381265411370" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:9a4a32cab3dfc74483cd00124122e9c432bb011a502d9b80200e2983f6910aa5" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/analytics/detect_fake_views?item_id=7460937381265411370' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-analytics-detect_fake_views" } }, "/apis/v1/tikhub/tiktok/analytics/fetch_comment_keywords": { "get": { "description": "TikTok (analytics).\n\n### Purpose\n- Analyze popular keywords and topics in video comments to uncover user feedback\n- Extract main content and opinions from audience comments to understand viewer focus points\n- Support creators in optimizing content strategy and enhancing audience engagement and connection\n\n### Parameters\n- item_id: Video ID, required parameter, can be obtained from video sharing links or TikTok Studio\n\n### Return Description\n- `item_id`: The requested video ID\n- `key_words`: List of keywords extracted from comments, including:\n - `key_word`: Keyword text\n - `comments`: List of comments containing this keyword, each comment includes:\n - `cid`: Comment ID\n - `text`: Comment content\n - `create_date`: Comment creation timestamp\n - `digg_count`: Number of likes on the comment\n - `comment_type`: Comment type\n - `comment_author`: Comment author information\n - `uid`: User ID\n - `nick_name`: User nickname\n - `cover`: User avatar information\n - `url_list`: List of avatar URLs\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_analytics_fetch_comment_keywords", "responses": { "200": { "description": "Successful Response\n\n### Return Description\n- `item_id`: The requested video ID\n- `key_words`: List of keywords extracted from comments, including:\n - `key_word`: Keyword text\n - `comments`: List of comments containing this keyword, each comment includes:\n - `cid`: Comment ID\n - `text`: Comment content\n - `create_date`: Comment creation timestamp\n - `digg_count`: Number of likes on the comment\n - `comment_type`: Comment type\n - `comment_author`: Comment author information\n - `uid`: User ID\n - `nick_name`: User nickname\n - `cover`: User avatar information\n - `url_list`: List of avatar URLs\n\nThe media-type example is an illustrative response from the official documentation, not a live response. Its router and params metadata use upstream naming.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" }, "example": { "code": 200, "router": "/api/v1/tiktok/analytics/fetch_comment_keywords", "params": { "item_id": "7502551047378832671" }, "data": { "item_id": "7502551047378832671", "key_words": [ { "key_word": "tik tok", "comments": [ { "cid": "7502621950457463574", "comment_author": { "nick_name": "ollie_russell05", "uid": "7332627012203414560" }, "create_date": 1746840350, "digg_count": 17, "text": "Imagine been tik tok and only getting 700 likes 🥀🙏😭" } ] }, { "key_word": "go viral", "comments": [ { "cid": "7502743477604680465", "comment_author": { "nick_name": "★ 🇦🇫", "uid": "7274239704915149829" }, "create_date": 1746868614, "digg_count": 13, "text": "I want to go viral" } ] } ] } } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_comment_keywords", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "38ec0f97e053" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/analytics/fetch_comment_keywords", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_analytics_fetch_comment_keywords", "method": "GET", "path": "/apis/v1/tikhub/tiktok/analytics/fetch_comment_keywords" }, "parameters": [ { "name": "item_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Video ID, required parameter, can be obtained from video sharing links or TikTok Studio", "title": "Item Id" }, "description": "Video ID, required parameter, can be obtained from video sharing links or TikTok Studio", "example": "7502551047378832671" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:4eb11aa5329faba42aa2d8f6d6315e9378560d6eb625025d1a68353019ba80fc" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/analytics/fetch_comment_keywords?item_id=7502551047378832671' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-analytics-fetch_comment_keywords" } }, "/apis/v1/tikhub/tiktok/analytics/fetch_creator_info_and_milestones": { "get": { "description": "TikTok (analytics).\n\n### Purpose\n- Retrieve basic information and key metrics for TikTok creator accounts\n- View creator growth journey and important achieved milestones\n- Analyze creator account development trajectory, understand follower growth and content influence changes\n\n### Parameters\n- user_id: Creator user ID, required parameter, can be obtained from user profile URL or TikTok backend\n\n### Return Description\n- `user_id`: The requested creator ID\n- `creator_info`: The creator's basic information\n - `nickname`: Creator's display name\n - `sec_user_id`: Security user ID\n - `unique_id`: Unique username\n - `avatar_url`: Profile picture URL\n - `follower_count`: Number of followers\n - `like_count`: Total number of likes received\n- `milestones`: List of creator account milestones, each milestone includes:\n - `milestone`: Milestone type ID\n - `milestone_title`: Milestone title (e.g., \"Reached 1 million followers\")\n - `milestone_year`: Year when the milestone was achieved\n - `milestone_month_day`: Month and day when the milestone was achieved\n - `creator_summary`: Milestone-related description\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_analytics_fetch_creator_info_and_milestones", "responses": { "200": { "description": "Successful Response\n\n### Return Description\n- `user_id`: The requested creator ID\n- `creator_info`: The creator's basic information\n - `nickname`: Creator's display name\n - `sec_user_id`: Security user ID\n - `unique_id`: Unique username\n - `avatar_url`: Profile picture URL\n - `follower_count`: Number of followers\n - `like_count`: Total number of likes received\n- `milestones`: List of creator account milestones, each milestone includes:\n - `milestone`: Milestone type ID\n - `milestone_title`: Milestone title (e.g., \"Reached 1 million followers\")\n - `milestone_year`: Year when the milestone was achieved\n - `milestone_month_day`: Month and day when the milestone was achieved\n - `creator_summary`: Milestone-related description\n\nThe media-type example is an illustrative response from the official documentation, not a live response. Its router and params metadata use upstream naming.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" }, "example": { "code": 200, "router": "/api/v1/tiktok/analytics/fetch_creator_info_and_milestones", "params": { "user_id": "107955" }, "data": { "user_id": "107955", "creator_info": { "avatar_url": "https://p19-pu-sign-useast8.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:720:720.webp", "follower_count": 89812099, "like_count": 382411162, "nickname": "TikTok", "sec_user_id": "MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM", "unique_id": "tiktok" }, "milestones": [ { "milestone": 6, "milestone_month_day": "10/4", "milestone_title": "Reached 1 million followers", "milestone_year": "2015" }, { "milestone": 1, "milestone_month_day": "2/27", "milestone_title": "Started posting on TikTok", "milestone_year": "2015" } ] } } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_creator_info_and_milestones", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "03006839f1af" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/analytics/fetch_creator_info_and_milestones", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_analytics_fetch_creator_info_and_milestones", "method": "GET", "path": "/apis/v1/tikhub/tiktok/analytics/fetch_creator_info_and_milestones" }, "parameters": [ { "name": "user_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Creator user ID, required parameter, can be obtained from user profile URL or TikTok backend", "title": "User Id" }, "description": "Creator user ID, required parameter, can be obtained from user profile URL or TikTok backend", "example": "107955" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:80c879d18d0875e9250a1a284fda9d4e304f03cf5e4851c46a235b6511f4fdd1" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/analytics/fetch_creator_info_and_milestones?user_id=107955' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-analytics-fetch_creator_info_and_milestones" } }, "/apis/v1/tikhub/tiktok/analytics/fetch_video_metrics": { "get": { "description": "TikTok (analytics).\n\n### Purpose\n- Retrieve detailed analytics data for TikTok videos, including views, likes, comments, and favorites\n- Provide total statistics and daily trends for 14 days since the release date, facilitating video performance analysis\n- Help creators analyze content effectiveness, evaluate user engagement, and optimize content strategy\n\n### Parameters\n- item_id: Video ID, required parameter, can be obtained from video sharing links or TikTok Studio\n\n### Return Description\n- `item_id`: The requested video ID\n- `video_views`: Total number of video views\n - `value`: View count value\n- `video_views_14_days`: Daily view trends for the past 14 days\n - `interval`: Data interval type\n - `value`: List of daily data\n- `likes`: Total number of likes on the video\n - `value`: Like count value\n- `likes_14_days`: Daily like trends for the past 14 days\n- `comments`: Total number of comments on the video\n - `value`: Comment count value\n- `comments_14_days`: Daily comment trends for the past 14 days\n- `favorites`: Total number of times the video was favorited\n - `value`: Favorite count value\n- `favorites_14_days`: Daily favorite trends for the past 14 days\n- `video_summary`: Overview analysis of video performance\n - `title`: Overview title\n - `content`: Overview content\n - `summary_type`: Overview type\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_analytics_fetch_video_metrics", "responses": { "200": { "description": "Successful Response\n\n### Return Description\n- `item_id`: The requested video ID\n- `video_views`: Total number of video views\n - `value`: View count value\n- `video_views_14_days`: Daily view trends for the past 14 days\n - `interval`: Data interval type\n - `value`: List of daily data\n- `likes`: Total number of likes on the video\n - `value`: Like count value\n- `likes_14_days`: Daily like trends for the past 14 days\n- `comments`: Total number of comments on the video\n - `value`: Comment count value\n- `comments_14_days`: Daily comment trends for the past 14 days\n- `favorites`: Total number of times the video was favorited\n - `value`: Favorite count value\n- `favorites_14_days`: Daily favorite trends for the past 14 days\n- `video_summary`: Overview analysis of video performance\n - `title`: Overview title\n - `content`: Overview content\n - `summary_type`: Overview type\n\nThe media-type example is an illustrative response from the official documentation, not a live response. Its router and params metadata use upstream naming.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" }, "example": { "code": 200, "router": "/api/v1/tiktok/analytics/fetch_video_metrics", "params": { "item_id": "7502551047378832671" }, "data": { "item_id": "7502551047378832671", "video_views": { "value": 1555500 }, "likes": { "value": 11571 }, "comments": { "value": 6920 }, "favorites": { "value": 1243 }, "video_summary": { "title": "Overview", "content": "This post received more comments per view than most other posts." } } } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_video_metrics", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "e47456d769ff" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/analytics/fetch_video_metrics", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_analytics_fetch_video_metrics", "method": "GET", "path": "/apis/v1/tikhub/tiktok/analytics/fetch_video_metrics" }, "parameters": [ { "name": "item_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Video ID, required parameter, can be obtained from video sharing links or TikTok Studio", "title": "Item Id" }, "description": "Video ID, required parameter, can be obtained from video sharing links or TikTok Studio", "example": "7502551047378832671" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:0f6728a2cede87880b7e2286da7dde774e0daf5c61357e60ef491d8a0b7844c9" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/analytics/fetch_video_metrics?item_id=7502551047378832671' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-analytics-fetch_video_metrics" } }, "/apis/v1/tikhub/tiktok/app/v3/TTencrypt_algorithm": { "post": { "description": "TikTok (app/v3).\n\n### Purpose:\n- TikTok APP encryption algorithm, used to generate encrypted parameters in the request header.\n- The generated encrypted parameter list:\n - `x-ladon`\n - `x-khronos`\n - `x-argus`\n - `x-gorgon` (8404)\n\n### Parameters:\n- url: Full URL to be encrypted\n- data: If the interface is a POST request, please fill in the data of the POST request to participate in the encryption calculation. For GET requests, pass an empty string.\n- device_info: Device information, optional parameter, if not filled in, the default device information will be used, and the device information will modify the parameters in the URL passed in.\n\n### Return:\n- Encrypted parameter list\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_tiktok_app_v3_TTencrypt_algorithm", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Encrypted parameter list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok TTencrypt_algorithm", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "7d025ce89723" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/app/v3/TTencrypt_algorithm", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_tiktok_app_v3_TTencrypt_algorithm", "method": "POST", "path": "/apis/v1/tikhub/tiktok/app/v3/TTencrypt_algorithm" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "url": { "type": "string", "title": "Url", "description": "URL to be encrypted", "default": "https://api16-normal-useast5.tiktokv.us/tiktok/v1/upvote/item/list?user_id=6726034365602628610&offset=0&count=21&scene=0&iid=7425045478163400491&device_id=7349721034012280362&ac=WIFI&channel=googleplay&aid=1233&app_name=musical_ly&version_code=360704&version_name=36.7.4&device_platform=android&os=android&ab_version=36.7.4&ssmix=a&device_type=Pixel+6+Pro&device_brand=google&language=zh&os_api=33&os_version=13&openudid=711192517a8bbf03&manifest_version_code=2023607040&resolution=1440*2891&dpi=560&update_version_code=2023607040&_rticket=1728977220468&is_pad=0&app_type=normal&sys_region=CN&last_install_time=1728977141&timezone_name=America%2FLos_Angeles&app_language=zh-Hans&ac2=wifi5g&uoo=0&op_region=CN&timezone_offset=-28800&build_number=36.7.4&host_abi=arm64-v8a&locale=zh-Hans®ion=CN&content_language=en%2C&ts=1728977220&cdid=aa21524b-8633-49ca-8e6e-3275fe1672db" }, "data": { "type": "string", "title": "Data", "description": "If there is a POST request, please fill in the POST request data to participate in the encryption calculation", "default": "" }, "device_info": { "additionalProperties": true, "type": "object", "title": "Device Info", "description": "Device information, optional parameter; if not provided, default device information is used\n\nUsage: Device information, optional parameter, if not filled in, the default device information will be used, and the device information will modify the parameters in the URL passed in.", "default": { "aid": "1233", "cdid": "b820f79c-c74a-47b0-912f-ee3002ce60dc", "channel": "googleplay", "cookies": {}, "device_brand": "HONOR", "device_id": "7423364899755607598", "device_manufacturer": "HUAWEI", "device_model": "HONOR V30", "device_platform": "android", "device_type": "OXF-AN00", "dpi": 480, "host_abi": "arm64-v8a", "iid": "7423365134775469866", "lanusk": "", "manifest_version_code": "2023604040", "mc": "7E:EE:BA:BC:5E:40", "mssdk_token": "", "openudid": "63401ab5140125d1", "os_api": 29, "os_version": "10", "resolution": "2400*1080", "rom": "11.0.0.185C00", "rom_version": "OXF-AN00-user 11.0.0 HUAWEIOXF-AN00 185-CHN-LGRP3 release-keys", "server_time": 1728386909, "ua": "com.zhiliaoapp.musically/2023604040 (Linux; U; Android 10; zh_CN; OXF-AN00; Build/185-CHN-LGRP3;tt-ok/3.12.13.4-tiktok)", "update_version_code": "2023604040", "uuid": "350244698061054", "version_code": "360404", "version_name": "36.4.4" } } }, "type": "object", "title": "TikTok_APP_Encrypt_Request" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:63405d88cdf1230a20064221a9c208744aa48845e50d4a4f51d6221cd440e2ba" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-tiktok-app-v3-TTencrypt_algorithm" } }, "/apis/v1/tikhub/tiktok/app/v3/check_live_room_online": { "get": { "description": "TikTok (app/v3).\n\n### Purpose\n- Check if live room is online\n- The Room ID of the live room can be obtained from the `/tikhub/tiktok/web/get_live_room_id` interface through the live room link\n\n### Parameters\n- room_id: Live room id\n\n### Return\n- Whether online\n\nAPI references: `get_live_room_id` = `GET /tikhub/tiktok/web/get_live_room_id` (operationId: `get_tikhub_tiktok_web_get_live_room_id`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_app_v3_check_live_room_online", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Whether online", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok check_live_room_online", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "656c0b83ccaf" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/app/v3/check_live_room_online", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_app_v3_check_live_room_online", "method": "GET", "path": "/apis/v1/tikhub/tiktok/app/v3/check_live_room_online" }, "parameters": [ { "name": "room_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Live room id", "title": "Room Id" }, "description": "Live room id", "example": "7358603858249009962" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:d6beed14b5fd7be2f8414f13341ee54a4b0a643582ad585fba0a2ec1de742160" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/app/v3/check_live_room_online?room_id=7358603858249009962' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-app-v3-check_live_room_online" } }, "/apis/v1/tikhub/tiktok/app/v3/check_live_room_online_batch": { "post": { "description": "TikTok (app/v3).\n\n### Purpose\n- Batch check TikTok live rooms' online status, supports up to 50 room IDs\n- Room IDs can be retrieved from `/tikhub/tiktok/web/get_live_room_id`\n\n### Parameters\n- room_ids: List of TikTok live room IDs\n\n### Return\n- Online status per room\n\nAPI references: `get_live_room_id` = `GET /tikhub/tiktok/web/get_live_room_id` (operationId: `get_tikhub_tiktok_web_get_live_room_id`).\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_tiktok_app_v3_check_live_room_online_batch", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Online status per room", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok check_live_room_online_batch", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "cb48de0ed9f7" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/app/v3/check_live_room_online_batch", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_tiktok_app_v3_check_live_room_online_batch", "method": "POST", "path": "/apis/v1/tikhub/tiktok/app/v3/check_live_room_online_batch" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "room_ids": { "items": { "type": "string" }, "type": "array", "title": "Room Ids", "description": "List of TikTok live room IDs", "default": [ "7494491933781003054", "7494514925034113835", "7494520590523517739" ] } }, "type": "object", "title": "LiveRoomBatchCheckRequest" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:24e94bc90d7f7ad975c3cc7c40d1f95a9eb2764a3fb454531a162fbfcc0e86e1" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-tiktok-app-v3-check_live_room_online_batch" } }, "/apis/v1/tikhub/tiktok/app/v3/encrypt_decrypt_login_request": { "post": { "description": "TikTok (app/v3).\n\n### Purpose:\n- Encrypt/decrypt the TikTok APP login request body, used for encrypting and decrypting the request body of the login interface.\n### Parameters:\n- username: Username, can be ciphertext or plaintext.\n- password: Password, can be ciphertext or plaintext.\n- mode: Mode\n - `encrypt`: Encrypt\n - `decrypt`: Decrypt\n### Return:\n- Encrypted/decrypted request body\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_tiktok_app_v3_encrypt_decrypt_login_request", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Encrypted/decrypted request body", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok encrypt_decrypt_login_request", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "7c08de49d800" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/app/v3/encrypt_decrypt_login_request", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_tiktok_app_v3_encrypt_decrypt_login_request", "method": "POST", "path": "/apis/v1/tikhub/tiktok/app/v3/encrypt_decrypt_login_request" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "username": { "type": "string", "title": "Username", "description": "Plaintext or encrypted username", "default": "example_username" }, "password": { "type": "string", "title": "Password", "description": "Plaintext or encrypted password", "default": "example_password" }, "mode": { "description": "Encrypt or decrypt the input string\n\nUsage: Mode\n - `encrypt`: Encrypt\n - `decrypt`: Decrypt", "default": "encrypt", "allOf": [ { "type": "string", "enum": [ "encrypt", "decrypt" ], "title": "ModeEnum" } ] } }, "type": "object", "title": "TikTok_APP_Login_Encrypt_Decrypt_Request", "example": { "mode": "encrypt", "password": "example_password", "username": "example_username" } } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:91092b04b84a325aa7c8da81724c2d56ad84f1299996967cd8a479890322953f" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/tiktok/app/v3/encrypt_decrypt_login_request \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"mode\": \"encrypt\",\n \"password\": \"example_password\",\n \"username\": \"example_username\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-tiktok-app-v3-encrypt_decrypt_login_request" } }, "/apis/v1/tikhub/tiktok/app/v3/fetch_content_translate": { "post": { "description": "TikTok (app/v3).\n\n### Purpose:\n- Get content translation data\n### Parameters:\n- trg_lang: Target language\n - zh-Hans: Simplified Chinese\n - zh-Hant: Traditional Chinese\n - en: English\n - ja: Japanese\n - ko: Korean\n - fr: French\n - de: German\n - ru: Russian\n - es: Spanish\n - pt: Portuguese\n - vi: Vietnamese\n - th: Thai\n - id: Indonesian\n - ar: Arabic\n - it: Italian\n - tr: Turkish\n - he: Hebrew\n - pl: Polish\n - nl: Dutch\n - sv: Swedish\n - da: Danish\n - fi: Finnish\n - no: Norwegian\n - cs: Czech\n - hu: Hungarian\n- src_content: Source content, that is, the content that needs to be translated, the length does not exceed 5000 characters, if it exceeds 5000 characters, only the first 5000 characters will be translated.\n### Return:\n- Content translation data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_tiktok_app_v3_fetch_content_translate", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Content translation data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_content_translate", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "982559f4f566" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/app/v3/fetch_content_translate", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_tiktok_app_v3_fetch_content_translate", "method": "POST", "path": "/apis/v1/tikhub/tiktok/app/v3/fetch_content_translate" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "trg_lang": { "type": "string", "title": "Trg Lang", "description": "Target language ISO639-1 code, e.g. zh-Hans\n\nUsage: Target language\n - zh-Hans: Simplified Chinese\n - zh-Hant: Traditional Chinese\n - en: English\n - ja: Japanese\n - ko: Korean\n - fr: French\n - de: German\n - ru: Russian\n - es: Spanish\n - pt: Portuguese\n - vi: Vietnamese\n - th: Thai\n - id: Indonesian\n - ar: Arabic\n - it: Italian\n - tr: Turkish\n - he: Hebrew\n - pl: Polish\n - nl: Dutch\n - sv: Swedish\n - da: Danish\n - fi: Finnish\n - no: Norwegian\n - cs: Czech\n - hu: Hungarian", "default": "zh-Hans" }, "src_content": { "type": "string", "title": "Src Content", "description": "Source language content, i.e. the content to be translated\n\nUsage: Source content, that is, the content that needs to be translated, the length does not exceed 5000 characters, if it exceeds 5000 characters, only the first 5000 characters will be translated.", "default": "Hello, welcome to TikHub!" } }, "type": "object", "title": "TikTok_APP_V3_Content_Translate" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:cdda54b46c2af6c36ec43ac01eddb2f83fa8d4670d134e312c4c4155f0554d06" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-tiktok-app-v3-fetch_content_translate" } }, "/apis/v1/tikhub/tiktok/app/v3/fetch_creator_info": { "get": { "description": "TikTok (app/v3).\n\n### Purpose:\n- Get creator information, including the creator's basic information, number of fans, number of storefront products, shop live room and other information.\n### Parameters:\n- creator_uid: Creator uid\n### Return:\n- Creator information\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_app_v3_fetch_creator_info", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Creator information", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_creator_info", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "e67b064b07f2" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/app/v3/fetch_creator_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_app_v3_fetch_creator_info", "method": "GET", "path": "/apis/v1/tikhub/tiktok/app/v3/fetch_creator_info" }, "parameters": [ { "name": "creator_uid", "in": "query", "required": true, "schema": { "type": "string", "description": "Creator uid", "title": "Creator Uid" }, "description": "Creator uid", "example": "6555451606845243393" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:ce1c80222800d585ea9b878c083b9adccb6c88dd4827e0396e8e1cd49ccdbf7e" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/app/v3/fetch_creator_info?creator_uid=6555451606845243393' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-app-v3-fetch_creator_info" } }, "/apis/v1/tikhub/tiktok/app/v3/fetch_creator_search_insights": { "get": { "description": "TikTok (app/v3).\n\n### Purpose:\n- Get creator search insights data, used to understand trending search topics and creative inspiration\n### Parameters:\n- offset: Pagination offset, default 0\n- limit: Number per page, default 20\n- tab: Tab type, options:\n - all: All\n - content_gap: Content gap\n - follower_searched: Follower searched\n - life_style: Life style\n - topics: Topics\n - challenges: Challenges\n - sounds: Sounds\n - hashtags: Hashtags\n- language_filters: Language filters, separated by comma, options: id, de, en, es, fr, pt, vi, tr, ar, th, ja, ko\n- category_filters: Category filters, separated by comma, options: Gaming, Fashion, Tourism, Science, Food, Sports\n- creator_source: Creator source, default \"general_search\"\n- force_refresh: Force refresh, default False\n### Return:\n- Creator search insights data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_app_v3_fetch_creator_search_insights", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Creator search insights data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_creator_search_insights", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "aaa8c88d46f8" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/app/v3/fetch_creator_search_insights", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_app_v3_fetch_creator_search_insights", "method": "GET", "path": "/apis/v1/tikhub/tiktok/app/v3/fetch_creator_search_insights" }, "parameters": [ { "name": "category_filters", "in": "query", "required": false, "schema": { "type": "string", "description": "Category filters, separated by comma, options: Gaming, Fashion, Tourism, Science, Food, Sports", "default": "", "title": "Category Filters" }, "description": "Category filters, separated by comma, options: Gaming, Fashion, Tourism, Science, Food, Sports", "example": "" }, { "name": "creator_source", "in": "query", "required": false, "schema": { "type": "string", "description": "Creator source, default \"general_search\"", "default": "general_search", "title": "Creator Source" }, "description": "Creator source, default \"general_search\"", "example": "general_search" }, { "name": "force_refresh", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Force refresh", "default": false, "title": "Force Refresh" }, "description": "Force refresh", "example": false }, { "name": "language_filters", "in": "query", "required": false, "schema": { "type": "string", "description": "Language filters, separated by comma, options: id, de, en, es, fr, pt, vi, tr, ar, th, ja, ko", "default": "en", "title": "Language Filters" }, "description": "Language filters, separated by comma, options: id, de, en, es, fr, pt, vi, tr, ar, th, ja, ko", "example": "en" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number per page, default 20", "default": 20, "title": "Limit" }, "description": "Number per page, default 20", "example": 20 }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "description": "Pagination offset, default 0", "default": 0, "title": "Offset" }, "description": "Pagination offset, default 0", "example": 0 }, { "name": "tab", "in": "query", "required": false, "schema": { "type": "string", "description": "Tab type, options:\n - all: All\n - content_gap: Content gap\n - follower_searched: Follower searched\n - life_style: Life style\n - topics: Topics\n - challenges: Challenges\n - sounds: Sounds\n - hashtags: Hashtags", "default": "all", "title": "Tab" }, "description": "Tab type, options:\n - all: All\n - content_gap: Content gap\n - follower_searched: Follower searched\n - life_style: Life style\n - topics: Topics\n - challenges: Challenges\n - sounds: Sounds\n - hashtags: Hashtags", "example": "all" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:eb3d1626b6a4967fbe56121cd03ab77136f7c223c5ec48f9444650beb233d969" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-app-v3-fetch_creator_search_insights" } }, "/apis/v1/tikhub/tiktok/app/v3/fetch_creator_search_insights_detail": { "get": { "description": "TikTok (app/v3).\n\n### Purpose:\n- Get creator search insights detail data, used to query search statistics for specific query\n### Parameters:\n- query_id_str: Query ID, obtained from fetch_creator_search_insights response\n- time_range: Time range, options:\n - past_7_days: Past 7 days\n - past_30_days: Past 30 days (default)\n - past_60_days: Past 60 days\n - past_6_months: Past 6 months\n - custom: Custom range (requires start_date and end_date, cannot exceed 6 months)\n- start_date: Start timestamp (seconds), only for custom range\n- end_date: End timestamp (seconds), only for custom range\n- dimension_list: Dimension list, separated by comma, options: gender, age, country\n### Return:\n- Search insights detail data, including search trends, user demographics, etc.\n\nAPI references: `fetch_creator_search_insights` = `GET /tikhub/tiktok/app/v3/fetch_creator_search_insights` (operationId: `get_tikhub_tiktok_app_v3_fetch_creator_search_insights`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_app_v3_fetch_creator_search_insights_detail", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Search insights detail data, including search trends, user demographics, etc.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_creator_search_insights_detail", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "bb0057daf82b" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/app/v3/fetch_creator_search_insights_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_app_v3_fetch_creator_search_insights_detail", "method": "GET", "path": "/apis/v1/tikhub/tiktok/app/v3/fetch_creator_search_insights_detail" }, "parameters": [ { "name": "dimension_list", "in": "query", "required": false, "schema": { "type": "string", "description": "Dimension list, separated by comma, options: gender, age, country", "default": "gender,age,country", "title": "Dimension List" }, "description": "Dimension list, separated by comma, options: gender, age, country", "example": "gender,age,country" }, { "name": "end_date", "in": "query", "required": false, "schema": { "type": "integer", "description": "End timestamp (seconds), only for custom range. Required together with the other date when `time_range=\"custom\"`; the custom interval cannot exceed six months. Ignored for preset time ranges.", "title": "End Date" }, "description": "End timestamp (seconds), only for custom range. Required together with the other date when `time_range=\"custom\"`; the custom interval cannot exceed six months. Ignored for preset time ranges." }, { "name": "query_id_str", "in": "query", "required": true, "schema": { "type": "string", "description": "Query ID from fetch_creator_search_insights\n\nAPI references: `fetch_creator_search_insights` = `GET /tikhub/tiktok/app/v3/fetch_creator_search_insights` (operationId: `get_tikhub_tiktok_app_v3_fetch_creator_search_insights`).", "title": "Query Id Str" }, "description": "Query ID from fetch_creator_search_insights\n\nAPI references: `fetch_creator_search_insights` = `GET /tikhub/tiktok/app/v3/fetch_creator_search_insights` (operationId: `get_tikhub_tiktok_app_v3_fetch_creator_search_insights`).", "example": "122991006" }, { "name": "start_date", "in": "query", "required": false, "schema": { "type": "integer", "description": "Start timestamp (seconds), only effective when time_range=custom. Required together with the other date when `time_range=\"custom\"`; the custom interval cannot exceed six months. Ignored for preset time ranges.", "title": "Start Date" }, "description": "Start timestamp (seconds), only effective when time_range=custom. Required together with the other date when `time_range=\"custom\"`; the custom interval cannot exceed six months. Ignored for preset time ranges." }, { "name": "time_range", "in": "query", "required": false, "schema": { "type": "string", "description": "Time range, options:\n - past_7_days: Past 7 days\n - past_30_days: Past 30 days (default)\n - past_60_days: Past 60 days\n - past_6_months: Past 6 months\n - custom: Custom range (requires start_date and end_date, cannot exceed 6 months)", "default": "past_30_days", "title": "Time Range" }, "description": "Time range, options:\n - past_7_days: Past 7 days\n - past_30_days: Past 30 days (default)\n - past_60_days: Past 60 days\n - past_6_months: Past 6 months\n - custom: Custom range (requires start_date and end_date, cannot exceed 6 months)", "example": "past_30_days" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e25ded2c06d6422125bc4f1eab10ac8d7120c12d64f943f6b862e6bc39582b6f" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/app/v3/fetch_creator_search_insights_detail?dimension_list=gender%2Cage%2Ccountry&query_id_str=122991006&time_range=past_30_days' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-app-v3-fetch_creator_search_insights_detail" } }, "/apis/v1/tikhub/tiktok/app/v3/fetch_creator_search_insights_trend": { "get": { "description": "TikTok (app/v3).\n\n### Purpose:\n- Get creator search insights trend data, including search popularity by region and time\n### Parameters:\n- query_id_str: Query ID, obtained from fetch_creator_search_insights response\n- from_tab_path: From tab path, default \"TRENDING,TOPICS\"\n- query_analysis_required: Whether query analysis is required, default True\n### Return:\n- Search trend data, including regional popularity, time trends, etc.\n\nAPI references: `fetch_creator_search_insights` = `GET /tikhub/tiktok/app/v3/fetch_creator_search_insights` (operationId: `get_tikhub_tiktok_app_v3_fetch_creator_search_insights`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_app_v3_fetch_creator_search_insights_trend", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Search trend data, including regional popularity, time trends, etc.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_creator_search_insights_trend", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "eabe4ae0dba7" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/app/v3/fetch_creator_search_insights_trend", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_app_v3_fetch_creator_search_insights_trend", "method": "GET", "path": "/apis/v1/tikhub/tiktok/app/v3/fetch_creator_search_insights_trend" }, "parameters": [ { "name": "from_tab_path", "in": "query", "required": false, "schema": { "type": "string", "description": "From tab path, default \"TRENDING,TOPICS\"", "default": "TRENDING,TOPICS", "title": "From Tab Path" }, "description": "From tab path, default \"TRENDING,TOPICS\"", "example": "TRENDING,TOPICS" }, { "name": "query_analysis_required", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether query analysis is required", "default": true, "title": "Query Analysis Required" }, "description": "Whether query analysis is required", "example": true }, { "name": "query_id_str", "in": "query", "required": true, "schema": { "type": "string", "description": "Query ID from fetch_creator_search_insights\n\nAPI references: `fetch_creator_search_insights` = `GET /tikhub/tiktok/app/v3/fetch_creator_search_insights` (operationId: `get_tikhub_tiktok_app_v3_fetch_creator_search_insights`).", "title": "Query Id Str" }, "description": "Query ID from fetch_creator_search_insights\n\nAPI references: `fetch_creator_search_insights` = `GET /tikhub/tiktok/app/v3/fetch_creator_search_insights` (operationId: `get_tikhub_tiktok_app_v3_fetch_creator_search_insights`).", "example": "7555720035176562699" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:29fba54a93416ae9bf587bf6d0c46f6ab2fbc7a45e121012e89a8f4e7ac9c645" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/app/v3/fetch_creator_search_insights_trend?from_tab_path=TRENDING%2CTOPICS&query_analysis_required=true&query_id_str=7555720035176562699' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-app-v3-fetch_creator_search_insights_trend" } }, "/apis/v1/tikhub/tiktok/app/v3/fetch_creator_search_insights_videos": { "get": { "description": "TikTok (app/v3).\n\n### Purpose:\n- Get creator search insights related videos, query popular related videos for the search term\n### Parameters:\n- keyword: Search keyword, obtained from fetch_creator_search_insights or fetch_creator_search_insights_trend\n- offset: Pagination offset, default 0\n- count: Number per page, default 20\n### Return:\n- Related popular videos list\n\nAPI references: `fetch_creator_search_insights` = `GET /tikhub/tiktok/app/v3/fetch_creator_search_insights` (operationId: `get_tikhub_tiktok_app_v3_fetch_creator_search_insights`); `fetch_creator_search_insights_trend` = `GET /tikhub/tiktok/app/v3/fetch_creator_search_insights_trend` (operationId: `get_tikhub_tiktok_app_v3_fetch_creator_search_insights_trend`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_app_v3_fetch_creator_search_insights_videos", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Related popular videos list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_creator_search_insights_videos", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "84287560997b" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/app/v3/fetch_creator_search_insights_videos", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_app_v3_fetch_creator_search_insights_videos", "method": "GET", "path": "/apis/v1/tikhub/tiktok/app/v3/fetch_creator_search_insights_videos" }, "parameters": [ { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number per page, default 20", "default": 20, "title": "Count" }, "description": "Number per page, default 20", "example": 20 }, { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Search keyword, obtained from fetch_creator_search_insights or fetch_creator_search_insights_trend\n\nAPI references: `fetch_creator_search_insights` = `GET /tikhub/tiktok/app/v3/fetch_creator_search_insights` (operationId: `get_tikhub_tiktok_app_v3_fetch_creator_search_insights`); `fetch_creator_search_insights_trend` = `GET /tikhub/tiktok/app/v3/fetch_creator_search_insights_trend` (operationId: `get_tikhub_tiktok_app_v3_fetch_creator_search_insights_trend`).", "title": "Keyword" }, "description": "Search keyword, obtained from fetch_creator_search_insights or fetch_creator_search_insights_trend\n\nAPI references: `fetch_creator_search_insights` = `GET /tikhub/tiktok/app/v3/fetch_creator_search_insights` (operationId: `get_tikhub_tiktok_app_v3_fetch_creator_search_insights`); `fetch_creator_search_insights_trend` = `GET /tikhub/tiktok/app/v3/fetch_creator_search_insights_trend` (operationId: `get_tikhub_tiktok_app_v3_fetch_creator_search_insights_trend`).", "example": "headshots 2 2 3" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "description": "Pagination offset, default 0", "default": 0, "title": "Offset" }, "description": "Pagination offset, default 0", "example": 0 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:b50a13e8d0b31589ed42b815bc6241cdc7549400494ad5d7f9a06e186e5810fd" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/app/v3/fetch_creator_search_insights_videos?count=20&keyword=headshots+2+2+3&offset=0' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-app-v3-fetch_creator_search_insights_videos" } }, "/apis/v1/tikhub/tiktok/app/v3/fetch_general_search_result": { "get": { "description": "TikTok (app/v3).\n\n### Purpose:\n- Get comprehensive search results of specified keywords\n### Parameters:\n- keyword: Keyword\n- offset: Offset\n- count: Number\n- sort_type: 0-Relatedness, 1-Most likes\n- publish_time: 0-Unlimited, 1-Last day, 7-Last week, 30-Last month, 90-Last three months, 180-Last half year\n### Return:\n- Comprehensive search results\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_app_v3_fetch_general_search_result", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Comprehensive search results", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_general_search_result", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "5df598f552bc" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/app/v3/fetch_general_search_result", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_app_v3_fetch_general_search_result", "method": "GET", "path": "/apis/v1/tikhub/tiktok/app/v3/fetch_general_search_result" }, "parameters": [ { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number", "default": 20, "title": "Count" }, "description": "Number", "example": 20 }, { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Keyword", "title": "Keyword" }, "description": "Keyword", "example": "Zhonghua Niang" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "description": "Offset", "default": 0, "title": "Offset" }, "description": "Offset", "example": 0 }, { "name": "publish_time", "in": "query", "required": false, "schema": { "type": "integer", "description": "Publish time\n\nUsage: 0-Unlimited, 1-Last day, 7-Last week, 30-Last month, 90-Last three months, 180-Last half year", "default": 0, "title": "Publish Time" }, "description": "Publish time\n\nUsage: 0-Unlimited, 1-Last day, 7-Last week, 30-Last month, 90-Last three months, 180-Last half year", "example": 0 }, { "name": "sort_type", "in": "query", "required": false, "schema": { "type": "integer", "description": "Sort type\n\nUsage: 0-Relatedness, 1-Most likes", "default": 0, "title": "Sort Type" }, "description": "Sort type\n\nUsage: 0-Relatedness, 1-Most likes", "example": 0 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:72831398ab7f244fda08a3b5d408516220bbdd6f6d089429a76537f3588c178d" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/app/v3/fetch_general_search_result?count=20&keyword=Zhonghua+Niang&offset=0&publish_time=0&sort_type=0' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-app-v3-fetch_general_search_result" } }, "/apis/v1/tikhub/tiktok/app/v3/fetch_hashtag_detail": { "get": { "description": "TikTok (app/v3).\n\n### Purpose:\n- Get details of specified hashtag\n### Parameters:\n- ch_id: Hashtag id\n- region: Region, supports US, GB, FR, JP, VN, SG, default US\n### Return:\n- Hashtag details data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_app_v3_fetch_hashtag_detail", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Hashtag details data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_hashtag_detail", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "8bb76fd54b50" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/app/v3/fetch_hashtag_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_app_v3_fetch_hashtag_detail", "method": "GET", "path": "/apis/v1/tikhub/tiktok/app/v3/fetch_hashtag_detail" }, "parameters": [ { "name": "ch_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Hashtag id", "title": "Ch Id" }, "description": "Hashtag id", "example": "7551" }, { "name": "region", "in": "query", "required": false, "schema": { "type": "string", "description": "Region (US, GB, FR, JP, VN, SG)", "default": "US", "title": "Region" }, "description": "Region (US, GB, FR, JP, VN, SG)" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:4c99b4d5548155988d33deafd1c0b1b1e4ae57ef403e34fe657ea090cf652c1f" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/app/v3/fetch_hashtag_detail?ch_id=7551' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-app-v3-fetch_hashtag_detail" } }, "/apis/v1/tikhub/tiktok/app/v3/fetch_hashtag_search_result": { "get": { "description": "TikTok (app/v3).\n\n### Purpose:\n- Get hashtag search results of specified keywords\n### Parameters:\n- keyword: Keyword\n- offset: Offset\n- count: Number\n### Return:\n- Hashtag search results\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_app_v3_fetch_hashtag_search_result", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Hashtag search results", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_hashtag_search_result", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "86121e6728d8" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/app/v3/fetch_hashtag_search_result", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_app_v3_fetch_hashtag_search_result", "method": "GET", "path": "/apis/v1/tikhub/tiktok/app/v3/fetch_hashtag_search_result" }, "parameters": [ { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number", "default": 20, "title": "Count" }, "description": "Number" }, { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Keyword", "title": "Keyword" }, "description": "Keyword", "example": "Cat" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "description": "Offset", "default": 0, "title": "Offset" }, "description": "Offset" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:d5eefd8d08e1afd1ac3ef770bc9a0fe8ea4015ae04be71a49bfd913389195fbd" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/app/v3/fetch_hashtag_search_result?keyword=Cat' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-app-v3-fetch_hashtag_search_result" } }, "/apis/v1/tikhub/tiktok/app/v3/fetch_hashtag_video_list": { "get": { "description": "TikTok (app/v3).\n\n### Purpose:\n- Get video list of specified hashtag\n### Parameters:\n- ch_id: Hashtag id\n- cursor: Cursor, used for paging, the first page is 0, the second page is the cursor value in the first response.\n- count: Number\n- region: Region, supports US, GB, FR, JP, VN, SG, default US\n### Return:\n- Hashtag video list data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_app_v3_fetch_hashtag_video_list", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Hashtag video list data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_hashtag_video_list", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "57cee4257bf1" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/app/v3/fetch_hashtag_video_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_app_v3_fetch_hashtag_video_list", "method": "GET", "path": "/apis/v1/tikhub/tiktok/app/v3/fetch_hashtag_video_list" }, "parameters": [ { "name": "ch_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Hashtag id", "title": "Ch Id" }, "description": "Hashtag id", "example": "7551" }, { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number", "default": 10, "title": "Count" }, "description": "Number" }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "integer", "description": "Cursor, used for paging, the first page is 0, the second page is the cursor value in the first response.", "default": 0, "title": "Cursor" }, "description": "Cursor, used for paging, the first page is 0, the second page is the cursor value in the first response." }, { "name": "region", "in": "query", "required": false, "schema": { "type": "string", "description": "Region (US, GB, FR, JP, VN, SG)", "default": "US", "title": "Region" }, "description": "Region (US, GB, FR, JP, VN, SG)" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:2be5f28cf5cbc188e64d8f508310b5a12ae84a0f79ecee0e2eb14cd4cb0d4492" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/app/v3/fetch_hashtag_video_list?ch_id=7551' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-app-v3-fetch_hashtag_video_list" } }, "/apis/v1/tikhub/tiktok/app/v3/fetch_home_feed": { "post": { "description": "TikTok (app/v3).\n\n### Purpose:\n- Get home feed(recommend) video data\n### Parameters:\n- cookie: User's own cookie, optional parameter, used for personalized recommendation of interface returned data.\n### Return:\n- Video recommend data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_tiktok_app_v3_fetch_home_feed", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Video recommend data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_home_feed", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "065b3f54a1e6" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/app/v3/fetch_home_feed", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_tiktok_app_v3_fetch_home_feed", "method": "POST", "path": "/apis/v1/tikhub/tiktok/app/v3/fetch_home_feed" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User's own cookie, optional parameter, used for personalized recommendations of interface return data.", "default": "" } }, "type": "object", "title": "TikTok_APP_V3_Home_Feed" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:9ac193aff3250934d18c06b8e52e246092c00f072d50a12fb0b335ec54523123" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-tiktok-app-v3-fetch_home_feed" } }, "/apis/v1/tikhub/tiktok/app/v3/fetch_live_daily_rank": { "get": { "description": "TikTok (app/v3).\n\n### Purpose:\n- Get live daily rank data\n### Parameters:\n- anchor_id: Anchor id, which can be obtained from the live room information interface, use the default value, this parameter will affect the returned data, you can try different anchor ids of different live rooms.\n- room_id: Live room id, which can be obtained from the live room information interface, use the default value, this parameter will affect the returned data, you can try different room ids of different live rooms.\n- rank_type: Rank type, parameter values are as follows:\n\n | type | rankName | Group Type | Description |\n |------|----------|------------|-------------|\n | 0 | `hourly_rank` | GIFT_RANK | Hourly Rank |\n | 1 | `weekly_rank` | GIFT_RANK | Weekly Rank |\n | 5 | `rookie_star_rank` | GIFT_RANK | Rookie Star Rank |\n | 6 | `sale_rank` | E_COMMERCE | Sale Rank |\n | 8 | `daily_rank` | GIFT_RANK | Daily Rank |\n | 10 | `weekly_game_rank` | GAME_RANK | Weekly Game Rank |\n | 11 | `daily_game_rank` | GAME_RANK | Daily Game Rank |\n | 12 | `hall_of_fame_rank` | GIFT_RANK | Hall of Fame Rank |\n | 13 | `champion_tournament` | GIFT_RANK | Champion Tournament (includes phase_one/two/three) |\n | 14 | `daily_rookie_star_rank` | GIFT_RANK | Daily Rookie Star Rank |\n | 15 | `fans_team_rank` | GIFT_RANK | Fans Team Rank |\n | 16 | `ranking_league` | GIFT_RANK | Ranking League (App display: D5 Level Rank) |\n | 20 | `pubg` | GAME_RANK | PUBG Rank |\n | 21 | `mlbb` | GAME_RANK | MLBB Rank (Mobile Legends: Bang Bang) |\n | 22 | `free_fire` | GAME_RANK | Free Fire Rank |\n | 23 | `sub_weekly_game_rank1` | GAME_RANK | Sub Weekly Game Rank 1 |\n | 24 | `sub_weekly_game_rank2` | GAME_RANK | Sub Weekly Game Rank 2 |\n | 25 | `sub_weekly_game_rank3` | GAME_RANK | Sub Weekly Game Rank 3 |\n | 26 | `collectibles` | E_COMMERCE | Collectibles Rank |\n | 27 | `beauty` | E_COMMERCE | Beauty Rank |\n | 28 | `women_wear` | E_COMMERCE | Women Wear Rank |\n | 29 | `sale_rank_daily` | E_COMMERCE | Daily Sale Rank |\n | 1001 | `league_campaign_rank` | GIFT_RANK | League Campaign Rank |\n | -1 | `unknown` | DEFAULT | Unknown |\n\n- region_type: Region type, use the default value, the specific meaning is unknown.\n- gap_interval: Time interval, use the default value to represent the current day, use -1 to represent the ranking record.\n- cookie: User's own cookie, optional parameter, used when the interface is not available.\n### Return:\n- Live daily rank data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_app_v3_fetch_live_daily_rank", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Live daily rank data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_live_daily_rank", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "0060f826de4a" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/app/v3/fetch_live_daily_rank", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_app_v3_fetch_live_daily_rank", "method": "GET", "path": "/apis/v1/tikhub/tiktok/app/v3/fetch_live_daily_rank" }, "parameters": [ { "name": "anchor_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Anchor id, which can be obtained from the live room information interface, use the default value, this parameter will affect the returned data, you can try different anchor ids of different live rooms.", "default": "6952422426752205830", "title": "Anchor Id" }, "description": "Anchor id, which can be obtained from the live room information interface, use the default value, this parameter will affect the returned data, you can try different anchor ids of different live rooms." }, { "name": "cookie", "in": "query", "required": false, "schema": { "type": "string", "description": "User's own cookie, optional parameter, used when the interface is not available.", "default": "", "title": "Cookie" }, "description": "User's own cookie, optional parameter, used when the interface is not available." }, { "name": "gap_interval", "in": "query", "required": false, "schema": { "type": "integer", "description": "Time interval, use the default value to represent the current day, use -1 to represent the ranking record.", "default": 0, "title": "Gap Interval" }, "description": "Time interval, use the default value to represent the current day, use -1 to represent the ranking record." }, { "name": "rank_type", "in": "query", "required": false, "schema": { "type": "integer", "description": "Rank type, parameter values are as follows:", "default": 8, "title": "Rank Type" }, "description": "Rank type, parameter values are as follows:" }, { "name": "region_type", "in": "query", "required": false, "schema": { "type": "integer", "description": "Region type, use the default value, the specific meaning is unknown.", "default": 1, "title": "Region Type" }, "description": "Region type, use the default value, the specific meaning is unknown." }, { "name": "room_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Live room id, which can be obtained from the live room information interface, use the default value, this parameter will affect the returned data, you can try different room ids of different live rooms.", "default": "7380221319910312750", "title": "Room Id" }, "description": "Live room id, which can be obtained from the live room information interface, use the default value, this parameter will affect the returned data, you can try different room ids of different live rooms." } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:0218e7e0f5a11c16f67eee0dda634ac5c00518deef04c2c7ce38714a80b24cdc" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-app-v3-fetch_live_daily_rank" } }, "/apis/v1/tikhub/tiktok/app/v3/fetch_live_ranking_list": { "get": { "description": "TikTok (app/v3).\n\n### Purpose:\n- Get ranking list of audience in live room\n### Parameters:\n- room_id: Live room id\n- anchor_id: Anchor id\n### Return:\n- Ranking list data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_app_v3_fetch_live_ranking_list", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Ranking list data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_live_ranking_list", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "c203e23fd81d" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/app/v3/fetch_live_ranking_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_app_v3_fetch_live_ranking_list", "method": "GET", "path": "/apis/v1/tikhub/tiktok/app/v3/fetch_live_ranking_list" }, "parameters": [ { "name": "anchor_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Anchor ID", "title": "Anchor Id" }, "description": "Anchor ID", "example": "7222941468722758702" }, { "name": "room_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Live room id", "title": "Room Id" }, "description": "Live room id", "example": "7358603858249009962" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e2b86b34e7872d720e7630504733434854a2092089f92daebae6e692f5892df1" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/app/v3/fetch_live_ranking_list?anchor_id=7222941468722758702&room_id=7358603858249009962' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-app-v3-fetch_live_ranking_list" } }, "/apis/v1/tikhub/tiktok/app/v3/fetch_live_room_info": { "get": { "description": "TikTok (app/v3).\n\n### Purpose:\n- Get data of specified live room\n### Parameters:\n- room_id: Live room id\n### Return:\n- Live room data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_app_v3_fetch_live_room_info", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Live room data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_live_room_info", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "b00bcabe8c71" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/app/v3/fetch_live_room_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_app_v3_fetch_live_room_info", "method": "GET", "path": "/apis/v1/tikhub/tiktok/app/v3/fetch_live_room_info" }, "parameters": [ { "name": "room_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Live room id", "title": "Room Id" }, "description": "Live room id", "example": "7358603858249009962" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:9c81a7054441aab8ae856a702c3214a4330551f40140db7a9a4a9513a1d31651" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/app/v3/fetch_live_room_info?room_id=7358603858249009962' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-app-v3-fetch_live_room_info" } }, "/apis/v1/tikhub/tiktok/app/v3/fetch_live_room_product_list": { "get": { "description": "TikTok (app/v3).\n\n### Purpose\n- Get live room product list data\n\n### Parameters\n- room_id: Live room id, required parameter.\n- author_id: Anchor id, required parameter.\n- page_size: Number per page, optional parameter, default is 15.\n- offset: Page turning cursor, optional parameter, default is 0, increasing by 15 each time.\n- region: Region, optional parameter, default is `US`, if you use other regions, such as: `VN`, please bring your own Cookie, otherwise you will not be able to get data.\n- cookie: User's own cookie, optional parameter, used to crawl data from regions other than `US`.\n\n### Get Parameters\n- Step 1: Use the interface `f\"{API_Base_URL}/tikhub/tiktok/web/get_live_room_id\"` to get the live room id (room_id).\n- Step 2: Use the interface `f\"{API_Base_URL}/tikhub/tiktok/app/v3/fetch_live_room_info\"` to get the live room information.\n- Step 3: Use the JSONPATH in the JSON data returned in the second step to get the value of the field `$.data.data.owner.id_str` as the anchor id (author_id).\n\n### Return\n- Live room product list data\n\nAPI references: `fetch_live_room_info` = `GET /tikhub/tiktok/app/v3/fetch_live_room_info` (operationId: `get_tikhub_tiktok_app_v3_fetch_live_room_info`); `get_live_room_id` = `GET /tikhub/tiktok/web/get_live_room_id` (operationId: `get_tikhub_tiktok_web_get_live_room_id`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_app_v3_fetch_live_room_product_list", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Live room product list data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_live_room_product_list", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "0791576adf24" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/app/v3/fetch_live_room_product_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_app_v3_fetch_live_room_product_list", "method": "GET", "path": "/apis/v1/tikhub/tiktok/app/v3/fetch_live_room_product_list" }, "parameters": [ { "name": "author_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Anchor ID", "title": "Author Id" }, "description": "Anchor ID", "example": "7408859677050274859" }, { "name": "cookie", "in": "query", "required": false, "schema": { "type": "string", "description": "User's own cookie, optional parameter, used to crawl data from regions other than `US`.", "default": "", "title": "Cookie" }, "description": "User's own cookie, optional parameter, used to crawl data from regions other than `US`." }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page turning cursor, optional parameter, default is 0, increasing by 15 each time.", "default": 0, "title": "Offset" }, "description": "Page turning cursor, optional parameter, default is 0, increasing by 15 each time." }, { "name": "page_size", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number per page, optional parameter, default is 15.", "default": 15, "title": "Page Size" }, "description": "Number per page, optional parameter, default is 15." }, { "name": "region", "in": "query", "required": false, "schema": { "type": "string", "description": "Region, optional parameter, default is `US`, if you use other regions, such as: `VN`, please bring your own Cookie, otherwise you will not be able to get data.", "default": "US", "title": "Region" }, "description": "Region, optional parameter, default is `US`, if you use other regions, such as: `VN`, please bring your own Cookie, otherwise you will not be able to get data." }, { "name": "room_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Live room id", "title": "Room Id" }, "description": "Live room id", "example": "7420741353250507562" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:89c834b8ea982431a9ff798fbbea0da035f3b9314319d0a10db01abcc8f6388b" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/app/v3/fetch_live_room_product_list?author_id=7408859677050274859&room_id=7420741353250507562' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-app-v3-fetch_live_room_product_list" } }, "/apis/v1/tikhub/tiktok/app/v3/fetch_live_search_result": { "get": { "description": "TikTok (app/v3).\n\n### Purpose:\n- Get live search results of specified keywords\n### Parameters:\n- keyword: Keyword\n- offset: Offset, starting from 0, the second page gets the cursor value from the response as the offset to continue the request.\n- count: Number, do not exceed 20\n- region: Region, default is US-America, for optional values please refer to TikTok region codes or ISO 3166-1 alpha-2 country codes.\n### Return:\n- Live search results\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_app_v3_fetch_live_search_result", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Live search results", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_live_search_result", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "b7bdba8c50fe" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/app/v3/fetch_live_search_result", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_app_v3_fetch_live_search_result", "method": "GET", "path": "/apis/v1/tikhub/tiktok/app/v3/fetch_live_search_result" }, "parameters": [ { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number, do not exceed 20", "default": 20, "title": "Count", "maximum": 20 }, "description": "Number, do not exceed 20", "example": 20 }, { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Keyword", "title": "Keyword" }, "description": "Keyword", "example": "Cat" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "description": "Offset, starting from 0, the second page gets the cursor value from the response as the offset to continue the request.", "default": 0, "title": "Offset" }, "description": "Offset, starting from 0, the second page gets the cursor value from the response as the offset to continue the request.", "example": 0 }, { "name": "region", "in": "query", "required": false, "schema": { "type": "string", "description": "Region, default is US-America, for optional values please refer to TikTok region codes or ISO 3166-1 alpha-2 country codes.", "default": "US", "title": "Region" }, "description": "Region, default is US-America, for optional values please refer to TikTok region codes or ISO 3166-1 alpha-2 country codes.", "example": "US" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:1628272055b7e3996fae444e95541bd7fd0b01571c93d8e83a92c78e41531c27" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/app/v3/fetch_live_search_result?count=20&keyword=Cat&offset=0®ion=US' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-app-v3-fetch_live_search_result" } }, "/apis/v1/tikhub/tiktok/app/v3/fetch_location_search": { "get": { "description": "TikTok (app/v3).\n\n### Purpose:\n- Get location search results\n### Parameters:\n- keyword: Keyword\n- offset: Offset\n- count: Number\n### Return:\n- Location search results\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_app_v3_fetch_location_search", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Location search results", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_location_search", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "dca3aac79f2f" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/app/v3/fetch_location_search", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_app_v3_fetch_location_search", "method": "GET", "path": "/apis/v1/tikhub/tiktok/app/v3/fetch_location_search" }, "parameters": [ { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number", "default": 20, "title": "Count" }, "description": "Number" }, { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Keyword", "title": "Keyword" }, "description": "Keyword", "example": "Shanghai" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "description": "Offset", "default": 0, "title": "Offset" }, "description": "Offset" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:5d78f41a3278e3103667a6660b2a0555aaeb4d58e7a828e6310e47f3c03f2bb9" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/app/v3/fetch_location_search?keyword=Shanghai' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-app-v3-fetch_location_search" } }, "/apis/v1/tikhub/tiktok/app/v3/fetch_multi_video": { "post": { "description": "TikTok (app/v3).\n\n### Purpose\n- Batch Get Video Information, support photo, video, etc., up to 10 videos at a time.\n- If this interface reports an error, please use the fetch_multi_video_v3 interface.\n\n### Parameters\n- Root JSON body: List of video ids, up to 10 video ids are supported.\n\n### Return\n- Video data\n\n### Request body\nSend the request body as a JSON array of strings at the root.\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_tiktok_app_v3_fetch_multi_video", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Video data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_multi_video", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "fc591d17f7d3" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/app/v3/fetch_multi_video", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_tiktok_app_v3_fetch_multi_video", "method": "POST", "path": "/apis/v1/tikhub/tiktok/app/v3/fetch_multi_video" }, "requestBody": { "content": { "application/json": { "schema": { "items": { "type": "string" }, "type": "array", "title": "Aweme Ids", "description": "Video ID list Send the request body as a JSON array of strings at the root." }, "example": [ "7339393672959757570", "7339393672959757570", "7339393672959757570", "7339393672959757570", "7339393672959757570", "7339393672959757570", "7339393672959757570", "7339393672959757570", "7339393672959757570", "7339393672959757570" ] } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:c04402c8a55acbd00de016a0fdd4bf0fce4aacc24a7df0b6cab25ecd943773ec" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/tiktok/app/v3/fetch_multi_video \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '[\n \"7339393672959757570\",\n \"7339393672959757570\",\n \"7339393672959757570\",\n \"7339393672959757570\",\n \"7339393672959757570\",\n \"7339393672959757570\",\n \"7339393672959757570\",\n \"7339393672959757570\",\n \"7339393672959757570\",\n \"7339393672959757570\"\n]'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-tiktok-app-v3-fetch_multi_video" } }, "/apis/v1/tikhub/tiktok/app/v3/fetch_music_chart_list": { "get": { "description": "TikTok (app/v3).\n\n### Purpose:\n- Get TikTok music chart list data\n### Parameters:\n- scene: Chart type\n - 0: Top 50 (Popular top 50)\n - 1: Viral 50 (Viral top 50)\n- cursor: Pagination cursor, default 0\n- count: Number per page, default 50, max 50\n### Return:\n- Music chart data, including song info, ranking changes, etc.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_app_v3_fetch_music_chart_list", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Music chart data, including song info, ranking changes, etc.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_music_chart_list", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "cf1aa515eeb5" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/app/v3/fetch_music_chart_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_app_v3_fetch_music_chart_list", "method": "GET", "path": "/apis/v1/tikhub/tiktok/app/v3/fetch_music_chart_list" }, "parameters": [ { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number per page (max 50)", "default": 50, "title": "Count", "maximum": 50 }, "description": "Number per page (max 50)", "example": 50 }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "integer", "description": "Pagination cursor, default 0", "default": 0, "title": "Cursor" }, "description": "Pagination cursor, default 0", "example": 0 }, { "name": "scene", "in": "query", "required": false, "schema": { "type": "integer", "description": "Chart type: 0=Top 50, 1=Viral 50\n\nUsage: Chart type\n - 0: Top 50 (Popular top 50)\n - 1: Viral 50 (Viral top 50)", "default": 0, "title": "Scene" }, "description": "Chart type: 0=Top 50, 1=Viral 50\n\nUsage: Chart type\n - 0: Top 50 (Popular top 50)\n - 1: Viral 50 (Viral top 50)", "example": 0 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:2613393a352638350e62462c5bf5bb188475ebf6d22e1466ec4f123bf4cd1b9b" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-app-v3-fetch_music_chart_list" } }, "/apis/v1/tikhub/tiktok/app/v3/fetch_music_detail": { "get": { "description": "TikTok (app/v3).\n\n### Purpose:\n- Get details of specified music\n### Parameters:\n- music_id: Music id\n### Return:\n- Music details data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_app_v3_fetch_music_detail", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Music details data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_music_detail", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "0a0d748385f2" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/app/v3/fetch_music_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_app_v3_fetch_music_detail", "method": "GET", "path": "/apis/v1/tikhub/tiktok/app/v3/fetch_music_detail" }, "parameters": [ { "name": "music_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Music id", "title": "Music Id" }, "description": "Music id", "example": "6943027371519772674" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:cd1281d562437003948019513d8a4e7fcafe735e0daa9abb7be5be90e9013a60" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/app/v3/fetch_music_detail?music_id=6943027371519772674' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-app-v3-fetch_music_detail" } }, "/apis/v1/tikhub/tiktok/app/v3/fetch_music_search_result": { "get": { "description": "TikTok (app/v3).\n\n### Purpose:\n- Get music search results of specified keywords\n### Parameters:\n- keyword: Keyword\n- offset: Offset, starting from 0, the second page gets the cursor value from the response as the offset to continue the request.\n- count: Number, do not exceed 20\n- filter_by: Filter type, 0-All, 1-Title, 2-Author, default is 0-All\n- sort_type: Sort type, 0-Relatedness, 1-Most used, 2-Latest, 3-Shortest duration, 4-Longest duration, default is 0-Relatedness\n- region: Region, default is US-America, for optional values please refer to TikTok region codes or ISO 3166-1 alpha-2 country codes.\n### Return:\n- Music search results\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_app_v3_fetch_music_search_result", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Music search results", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_music_search_result", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "c35f9c760bad" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/app/v3/fetch_music_search_result", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_app_v3_fetch_music_search_result", "method": "GET", "path": "/apis/v1/tikhub/tiktok/app/v3/fetch_music_search_result" }, "parameters": [ { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number, do not exceed 20", "default": 20, "title": "Count", "maximum": 20 }, "description": "Number, do not exceed 20", "example": 20 }, { "name": "filter_by", "in": "query", "required": false, "schema": { "type": "integer", "description": "Filter type, 0-All, 1-Title, 2-Author, default is 0-All", "default": 0, "title": "Filter By" }, "description": "Filter type, 0-All, 1-Title, 2-Author, default is 0-All", "example": 0 }, { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Keyword", "title": "Keyword" }, "description": "Keyword", "example": "Cat" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "description": "Offset, starting from 0, the second page gets the cursor value from the response as the offset to continue the request.", "default": 0, "title": "Offset" }, "description": "Offset, starting from 0, the second page gets the cursor value from the response as the offset to continue the request.", "example": 0 }, { "name": "region", "in": "query", "required": false, "schema": { "type": "string", "description": "Region, default is US-America, for optional values please refer to TikTok region codes or ISO 3166-1 alpha-2 country codes.", "default": "US", "title": "Region" }, "description": "Region, default is US-America, for optional values please refer to TikTok region codes or ISO 3166-1 alpha-2 country codes.", "example": "US" }, { "name": "sort_type", "in": "query", "required": false, "schema": { "type": "integer", "description": "Sort type, 0-Relatedness, 1-Most used, 2-Latest, 3-Shortest duration, 4-Longest duration, default is 0-Relatedness", "default": 0, "title": "Sort Type" }, "description": "Sort type, 0-Relatedness, 1-Most used, 2-Latest, 3-Shortest duration, 4-Longest duration, default is 0-Relatedness", "example": 0 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:834825745552f661ed3ade83600d5e4eb56a9dc0925e3e64075cebd0baf42e80" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/app/v3/fetch_music_search_result?count=20&filter_by=0&keyword=Cat&offset=0®ion=US&sort_type=0' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-app-v3-fetch_music_search_result" } }, "/apis/v1/tikhub/tiktok/app/v3/fetch_music_video_list": { "get": { "description": "TikTok (app/v3).\n\n### Purpose:\n- Get video list of specified music\n### Parameters:\n- music_id: Music id\n- cursor: Cursor, used for paging, the first page is 0, the second page is the cursor value in the first response.\n- count: Number\n### Return:\n- Music video list data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_app_v3_fetch_music_video_list", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Music video list data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_music_video_list", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "0407881869e1" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/app/v3/fetch_music_video_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_app_v3_fetch_music_video_list", "method": "GET", "path": "/apis/v1/tikhub/tiktok/app/v3/fetch_music_video_list" }, "parameters": [ { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number", "default": 10, "title": "Count" }, "description": "Number" }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "integer", "description": "Cursor, used for paging, the first page is 0, the second page is the cursor value in the first response.", "default": 0, "title": "Cursor" }, "description": "Cursor, used for paging, the first page is 0, the second page is the cursor value in the first response." }, { "name": "music_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Music id", "title": "Music Id" }, "description": "Music id", "example": "6943027371519772674" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:96ffc1dd0e6a31d590cf4ec0a06683db7e3d737ad25e1472a462c1aa7dfb9d8b" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/app/v3/fetch_music_video_list?music_id=6943027371519772674' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-app-v3-fetch_music_video_list" } }, "/apis/v1/tikhub/tiktok/app/v3/fetch_one_video": { "get": { "description": "TikTok (app/v3).\n\n### Purpose:\n- Get single video data\n### Parameters:\n- aweme_id: Video id\n### Return:\n- Video data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_app_v3_fetch_one_video", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Video data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_one_video", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "233c9e56dad7" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/app/v3/fetch_one_video", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_app_v3_fetch_one_video", "method": "GET", "path": "/apis/v1/tikhub/tiktok/app/v3/fetch_one_video" }, "parameters": [ { "name": "aweme_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Video id", "title": "Aweme Id" }, "description": "Video id", "example": "7350810998023949599" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:77955fe0d15635857c070a6aa28493a874baf14b10f13e971e4bab6f9bc7a032" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/app/v3/fetch_one_video?aweme_id=7350810998023949599' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-app-v3-fetch_one_video" } }, "/apis/v1/tikhub/tiktok/app/v3/fetch_one_video_by_share_url_v2": { "get": { "description": "TikTok (app/v3).\n\n### Purpose:\n- Get single video data by sharing link V2, the data structure will be a bit different, and the region field will be returned.\n### Parameters:\n- share_url: Share link\n### Return:\n- Video data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_app_v3_fetch_one_video_by_share_url_v2", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Video data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_one_video_by_share_url", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "85f2a537d223" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/app/v3/fetch_one_video_by_share_url_v2", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_app_v3_fetch_one_video_by_share_url_v2", "method": "GET", "path": "/apis/v1/tikhub/tiktok/app/v3/fetch_one_video_by_share_url_v2" }, "parameters": [ { "name": "share_url", "in": "query", "required": true, "schema": { "type": "string", "description": "Share link", "title": "Share Url" }, "description": "Share link", "example": "https://www.tiktok.com/t/ZTFNEj8Hk/" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:77955fe0d15635857c070a6aa28493a874baf14b10f13e971e4bab6f9bc7a032" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/app/v3/fetch_one_video_by_share_url_v2?share_url=https%3A%2F%2Fwww.tiktok.com%2Ft%2FZTFNEj8Hk%2F' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-app-v3-fetch_one_video_by_share_url_v2" } }, "/apis/v1/tikhub/tiktok/app/v3/fetch_share_qr_code": { "get": { "description": "TikTok (app/v3).\n\n### Purpose:\n- Get share QR code\n### Parameters:\n- object_id: Object id, currently supports the uid in the response of the personal homepage interface as a parameter.\n### Return:\n- QR code image\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_app_v3_fetch_share_qr_code", "responses": { "200": { "description": "Successful Response\n\n### Return\n- QR code image", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_share_qr_code", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "530e2fa6697b" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/app/v3/fetch_share_qr_code", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_app_v3_fetch_share_qr_code", "method": "GET", "path": "/apis/v1/tikhub/tiktok/app/v3/fetch_share_qr_code" }, "parameters": [ { "name": "object_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Object id, currently supports the uid in the response of the personal homepage interface as a parameter.", "title": "Object Id" }, "description": "Object id, currently supports the uid in the response of the personal homepage interface as a parameter.", "example": "6762244951259661318" }, { "name": "schema_type", "in": "query", "required": false, "schema": { "type": "integer", "description": "Schema type", "default": 4, "title": "Schema Type" }, "description": "Schema type" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e9d550015db22d2227511809f6056db08ec6a71f11e014ad54b8167f915510de" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/app/v3/fetch_share_qr_code?object_id=6762244951259661318' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-app-v3-fetch_share_qr_code" } }, "/apis/v1/tikhub/tiktok/app/v3/fetch_share_short_link": { "get": { "description": "TikTok (app/v3).\n\n### Purpose:\n- Get share short link\n### Parameters:\n- url: Long link or link to convert\n### Return:\n- Short link\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_app_v3_fetch_share_short_link", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Short link", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_share_short_link", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "70a8015ea694" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/app/v3/fetch_share_short_link", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_app_v3_fetch_share_short_link", "method": "GET", "path": "/apis/v1/tikhub/tiktok/app/v3/fetch_share_short_link" }, "parameters": [ { "name": "url", "in": "query", "required": true, "schema": { "type": "string", "description": "Share link", "title": "Url" }, "description": "Share link", "example": "https://www.tiktok.com/passport/web/logout/" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:b3954335806451e670412ffb0b2d3f3ddc98633b5c05049bf0716a55e00a12d6" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/app/v3/fetch_share_short_link?url=https%3A%2F%2Fwww.tiktok.com%2Fpassport%2Fweb%2Flogout%2F' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-app-v3-fetch_share_short_link" } }, "/apis/v1/tikhub/tiktok/app/v3/fetch_similar_user_recommendations": { "get": { "description": "TikTok (app/v3).\n\n### Purpose:\n- Similar User Recommendations\n### Parameters:\n- sec_uid: User sec_uid\n- page_token: Page token, not required for the first request, for subsequent requests, pass the next_page_token value from the previous response.\n### Return:\n- Similar User Recommendations\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_app_v3_fetch_similar_user_recommendations", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Similar User Recommendations", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_similar_user_recommendations", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "79c520ab3028" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/app/v3/fetch_similar_user_recommendations", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_app_v3_fetch_similar_user_recommendations", "method": "GET", "path": "/apis/v1/tikhub/tiktok/app/v3/fetch_similar_user_recommendations" }, "parameters": [ { "name": "page_token", "in": "query", "required": false, "schema": { "type": "string", "description": "Page token, not required for the first request, for subsequent requests, pass the next_page_token value from the previous response.", "default": "", "title": "Page Token" }, "description": "Page token, not required for the first request, for subsequent requests, pass the next_page_token value from the previous response." }, { "name": "sec_uid", "in": "query", "required": true, "schema": { "type": "string", "description": "User sec_uid", "title": "Sec Uid" }, "description": "User sec_uid", "example": "MS4wLjABAAAA2_YTgxz3kLb2XoyC3xOXnosim3gdiqMtFHnjRvckabZJFQ40XBOVttDCiB5cwa3b" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:a1a0ebbf5f7c7c0a2408e0900ff510883d9a4c67136d54eeb51d6f1be9f02da2" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/app/v3/fetch_similar_user_recommendations?sec_uid=MS4wLjABAAAA2_YTgxz3kLb2XoyC3xOXnosim3gdiqMtFHnjRvckabZJFQ40XBOVttDCiB5cwa3b' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-app-v3-fetch_similar_user_recommendations" } }, "/apis/v1/tikhub/tiktok/app/v3/fetch_user_country_by_username": { "get": { "description": "TikTok (app/v3).\n\n### Purpose:\n- Get user account country by username\n### Parameters:\n- username: Username, which can be obtained from the user's homepage link, for example: https://www.tiktok.com/@tiktok, the username is tiktok.\n### Return:\n- User account country\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_app_v3_fetch_user_country_by_username", "responses": { "200": { "description": "Successful Response\n\n### Return\n- User account country", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_user_country_by_username", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "2c4053954715" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/app/v3/fetch_user_country_by_username", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_app_v3_fetch_user_country_by_username", "method": "GET", "path": "/apis/v1/tikhub/tiktok/app/v3/fetch_user_country_by_username" }, "parameters": [ { "name": "username", "in": "query", "required": true, "schema": { "type": "string", "description": "Username, which can be obtained from the user's homepage link, for example: https://www.tiktok.com/@tiktok, the username is tiktok.", "title": "Username" }, "description": "Username, which can be obtained from the user's homepage link, for example: https://www.tiktok.com/@tiktok, the username is tiktok.", "example": "tiktok" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:ff3c4c7d0c9defb2958f9982fd9ffce953e00a026d159df4814752d07570a811" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/app/v3/fetch_user_country_by_username?username=tiktok' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-app-v3-fetch_user_country_by_username" } }, "/apis/v1/tikhub/tiktok/app/v3/fetch_user_follower_list": { "get": { "description": "TikTok (app/v3).\n\n### Purpose:\n- Get follower list of specified user\n### Parameters:\n- user_id: User ID, this is a pure numeric version of the user ID (one of user_id and sec_user_id)\n- sec_user_id: User sec_user_id, this is a mixed letter and number version ID (one of user_id and sec_user_id)\n- count: Number, do not exceed 20, keep it fixed.\n- min_time: Minimum time for paging, use default value 0 for the first request, and use the min_time value returned by the last request for subsequent requests.\n- page_token: Page token, use default value \"\" for the first request, and use the page_token value returned by the last request for subsequent requests.\n### Return:\n- Follower list data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_app_v3_fetch_user_follower_list", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Follower list data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_user_follower_list", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "85e56f0f710c" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/app/v3/fetch_user_follower_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_app_v3_fetch_user_follower_list", "method": "GET", "path": "/apis/v1/tikhub/tiktok/app/v3/fetch_user_follower_list" }, "parameters": [ { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number, do not exceed 20, keep it fixed.", "default": 20, "title": "Count", "maximum": 20 }, "description": "Number, do not exceed 20, keep it fixed.", "example": 20 }, { "name": "min_time", "in": "query", "required": false, "schema": { "type": "integer", "description": "Minimum time for paging, use default value 0 for the first request, and use the min_time value returned by the last request for subsequent requests.", "default": 0, "title": "Min Time" }, "description": "Minimum time for paging, use default value 0 for the first request, and use the min_time value returned by the last request for subsequent requests.", "example": 0 }, { "name": "page_token", "in": "query", "required": false, "schema": { "type": "string", "description": "Page token, use default value \"\" for the first request, and use the page_token value returned by the last request for subsequent requests.", "default": "", "title": "Page Token" }, "description": "Page token, use default value \"\" for the first request, and use the page_token value returned by the last request for subsequent requests.", "example": "" }, { "name": "sec_user_id", "in": "query", "required": false, "schema": { "type": "string", "description": "User sec_user_id, this is a mixed letter and number version ID (one of user_id and sec_user_id)", "default": "", "title": "Sec User Id" }, "description": "User sec_user_id, this is a mixed letter and number version ID (one of user_id and sec_user_id)", "example": "MS4wLjABAAAA0lKrE0cVLLZCnVil-n-YEZlOoik9oeO3zOYQ08dqOEOw2pRSXWJdcSFw7lZeZcSP" }, { "name": "user_id", "in": "query", "required": false, "schema": { "type": "string", "description": "User ID, this is a pure numeric version of the user ID (one of user_id and sec_user_id)", "default": "", "title": "User Id" }, "description": "User ID, this is a pure numeric version of the user ID (one of user_id and sec_user_id)", "example": "7486586574684881927" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:289b59e8d18dc99c2eaf3c284071e69804242e778cc8ab92d35fd5ce20655d79" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-app-v3-fetch_user_follower_list" } }, "/apis/v1/tikhub/tiktok/app/v3/fetch_user_following_list": { "get": { "description": "TikTok (app/v3).\n\n### Purpose:\n- Get following list of specified user\n### Parameters:\n- user_id: User ID, this is a pure numeric version of the user ID (one of user_id and sec_user_id)\n- sec_user_id: User sec_user_id, this is a mixed letter and number version ID (one of user_id and sec_user_id)\n- count: Number, do not exceed 20, keep it fixed.\n- min_time: Minimum time for paging, use default value 0 for the first request, and use the min_time value returned by the last request for subsequent requests.\n- page_token: Page token, use default value \"\" for the first request, and use the page_token value returned by the last request for subsequent requests.\n### Return:\n- Following list data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_app_v3_fetch_user_following_list", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Following list data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_user_following_list", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "ec036d72efee" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/app/v3/fetch_user_following_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_app_v3_fetch_user_following_list", "method": "GET", "path": "/apis/v1/tikhub/tiktok/app/v3/fetch_user_following_list" }, "parameters": [ { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number, do not exceed 20, keep it fixed.", "default": 20, "title": "Count", "maximum": 20 }, "description": "Number, do not exceed 20, keep it fixed.", "example": 20 }, { "name": "min_time", "in": "query", "required": false, "schema": { "type": "integer", "description": "Minimum time for paging, use default value 0 for the first request, and use the min_time value returned by the last request for subsequent requests.", "default": 0, "title": "Min Time" }, "description": "Minimum time for paging, use default value 0 for the first request, and use the min_time value returned by the last request for subsequent requests.", "example": 0 }, { "name": "page_token", "in": "query", "required": false, "schema": { "type": "string", "description": "Page token, use default value \"\" for the first request, and use the page_token value returned by the last request for subsequent requests.", "default": "", "title": "Page Token" }, "description": "Page token, use default value \"\" for the first request, and use the page_token value returned by the last request for subsequent requests.", "example": "" }, { "name": "sec_user_id", "in": "query", "required": false, "schema": { "type": "string", "description": "User sec_user_id, this is a mixed letter and number version ID (one of user_id and sec_user_id)", "default": "", "title": "Sec User Id" }, "description": "User sec_user_id, this is a mixed letter and number version ID (one of user_id and sec_user_id)", "example": "MS4wLjABAAAA0lKrE0cVLLZCnVil-n-YEZlOoik9oeO3zOYQ08dqOEOw2pRSXWJdcSFw7lZeZcSP" }, { "name": "user_id", "in": "query", "required": false, "schema": { "type": "string", "description": "User ID, this is a pure numeric version of the user ID (one of user_id and sec_user_id)", "default": "", "title": "User Id" }, "description": "User ID, this is a pure numeric version of the user ID (one of user_id and sec_user_id)", "example": "7486586574684881927" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:85a3cd37638e287e39458aa950490f78f75399a77b829b2d3164c9ab5fd8ab16" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-app-v3-fetch_user_following_list" } }, "/apis/v1/tikhub/tiktok/app/v3/fetch_user_like_videos": { "get": { "description": "TikTok (app/v3).\n\n### Purpose\n- Get user like video data\n\n### Parameters\n- sec_user_id: User sec_user_id\n- max_cursor: Maximum cursor, used for paging, the first page is 0, the second page is the max_cursor value in the first response.\n- counts: Maximum count number\n\n### Return\n- User video data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_app_v3_fetch_user_like_videos", "responses": { "200": { "description": "Successful Response\n\n### Return\n- User video data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_user_like_videos", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "7e78b5f5e442" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/app/v3/fetch_user_like_videos", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_app_v3_fetch_user_like_videos", "method": "GET", "path": "/apis/v1/tikhub/tiktok/app/v3/fetch_user_like_videos" }, "parameters": [ { "name": "counts", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number per page", "default": 20, "title": "Counts" }, "description": "Number per page" }, { "name": "max_cursor", "in": "query", "required": false, "schema": { "type": "integer", "description": "Maximum cursor, used for paging, the first page is 0, the second page is the max_cursor value in the first response.", "default": 0, "title": "Max Cursor" }, "description": "Maximum cursor, used for paging, the first page is 0, the second page is the max_cursor value in the first response." }, { "name": "sec_user_id", "in": "query", "required": true, "schema": { "type": "string", "description": "User sec_user_id", "title": "Sec User Id" }, "description": "User sec_user_id", "example": "MS4wLjABAAAA-RkTGCGXLuLKRM5Xcuuwm7Mclg51I2ECO1RqOA7mJHuXFz99nztdi077Z2XmYHZV" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:44bcdfb4c7a94fb10e7ebc4c065ce3fa885014430d44347355ca58219bbb9e69" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/app/v3/fetch_user_like_videos?sec_user_id=MS4wLjABAAAA-RkTGCGXLuLKRM5Xcuuwm7Mclg51I2ECO1RqOA7mJHuXFz99nztdi077Z2XmYHZV' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-app-v3-fetch_user_like_videos" } }, "/apis/v1/tikhub/tiktok/app/v3/fetch_user_music_list": { "get": { "description": "TikTok (app/v3).\n\n### Purpose:\n- Get user music list data\n### Parameters:\n- sec_uid: User sec_uid\n- cursor: Cursor, used for paging, the first page is 0, the second page is the cursor value in the first response.\n- count: Number\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_app_v3_fetch_user_music_list", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_user_music_list", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "92c161b008f9" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/app/v3/fetch_user_music_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_app_v3_fetch_user_music_list", "method": "GET", "path": "/apis/v1/tikhub/tiktok/app/v3/fetch_user_music_list" }, "parameters": [ { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number", "default": 10, "title": "Count" }, "description": "Number" }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "integer", "description": "Cursor, used for paging, the first page is 0, the second page is the cursor value in the first response.", "default": 0, "title": "Cursor" }, "description": "Cursor, used for paging, the first page is 0, the second page is the cursor value in the first response." }, { "name": "sec_uid", "in": "query", "required": true, "schema": { "type": "string", "description": "User sec_uid", "title": "Sec Uid" }, "description": "User sec_uid", "example": "MS4wLjABAAAAqB08cUbXaDWqbD6MCga2RbGTuhfO2EsHayBYx08NDrN7IE3jQuRDNNN6YwyfH6_6" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e56c0f64759022cecb5502df30fd08faeb446c6d3a60cfc5fa77fb25dd390b27" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/app/v3/fetch_user_music_list?sec_uid=MS4wLjABAAAAqB08cUbXaDWqbD6MCga2RbGTuhfO2EsHayBYx08NDrN7IE3jQuRDNNN6YwyfH6_6' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-app-v3-fetch_user_music_list" } }, "/apis/v1/tikhub/tiktok/app/v3/fetch_user_post_videos": { "get": { "description": "TikTok (app/v3).\n\n### Purpose:\n- Get user homepage video data\n### Parameters:\n- sec_user_id: User sec_user_id, use sec_user_id to get user video data first, if sec_user_id is empty, use unique_id to get user video data.\n- max_cursor: Maximum cursor, used for paging, the first page is 0, the second page is the max_cursor value in the first response.\n- count: Maximum count number\n- sort_type: Sort type, 0-Latest, 1-Hot\n- unique_id: User unique_id, optional parameter, if sec_user_id is empty, use unique_id to get user video data, unique_id is also the user's username.\n- About the parameters of user ID, the priority is sec_user_id > unique_id, the higher the priority, the faster the speed, and it is recommended to use only sec_user_id to get user data.\n- region: Region, optional parameter, if not passed, the US region data will be used by default. After passing, the data of the corresponding country and region will be preferred, for example: US, GB, FR, JP, SG, VN, etc.\n### Return:\n- User video data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_app_v3_fetch_user_post_videos", "responses": { "200": { "description": "Successful Response\n\n### Return\n- User video data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_user_post_videos", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "4974b259f1d7" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/app/v3/fetch_user_post_videos", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_app_v3_fetch_user_post_videos", "method": "GET", "path": "/apis/v1/tikhub/tiktok/app/v3/fetch_user_post_videos" }, "parameters": [ { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number per page", "default": 20, "title": "Count" }, "description": "Number per page" }, { "name": "max_cursor", "in": "query", "required": false, "schema": { "type": "integer", "description": "Maximum cursor, used for paging, the first page is 0, the second page is the max_cursor value in the first response.", "default": 0, "title": "Max Cursor" }, "description": "Maximum cursor, used for paging, the first page is 0, the second page is the max_cursor value in the first response." }, { "name": "region", "in": "query", "required": false, "schema": { "type": "string", "description": "Region, optional; defaults to US data if not provided. When specified, returns data for that country/region, e.g. US, GB, FR\n\nUsage: Region, optional parameter, if not passed, the US region data will be used by default. After passing, the data of the corresponding country and region will be preferred, for example: US, GB, FR, JP, SG, VN, etc.", "default": "", "title": "Region" }, "description": "Region, optional; defaults to US data if not provided. When specified, returns data for that country/region, e.g. US, GB, FR\n\nUsage: Region, optional parameter, if not passed, the US region data will be used by default. After passing, the data of the corresponding country and region will be preferred, for example: US, GB, FR, JP, SG, VN, etc.", "example": "US" }, { "name": "sec_user_id", "in": "query", "required": false, "schema": { "type": "string", "description": "User sec_user_id, use sec_user_id to get user video data first, if sec_user_id is empty, use unique_id to get user video data.", "default": "", "title": "Sec User Id" }, "description": "User sec_user_id, use sec_user_id to get user video data first, if sec_user_id is empty, use unique_id to get user video data.", "example": "MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM" }, { "name": "sort_type", "in": "query", "required": false, "schema": { "type": "integer", "description": "Sort type, 0-Latest, 1-Hot", "default": 0, "title": "Sort Type" }, "description": "Sort type, 0-Latest, 1-Hot" }, { "name": "unique_id", "in": "query", "required": false, "schema": { "type": "string", "description": "User unique_id, optional parameter, if sec_user_id is empty, use unique_id to get user video data, unique_id is also the user's username.", "default": "", "title": "Unique Id" }, "description": "User unique_id, optional parameter, if sec_user_id is empty, use unique_id to get user video data, unique_id is also the user's username.", "example": "" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:44bcdfb4c7a94fb10e7ebc4c065ce3fa885014430d44347355ca58219bbb9e69" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-app-v3-fetch_user_post_videos" } }, "/apis/v1/tikhub/tiktok/app/v3/fetch_user_repost_videos": { "get": { "description": "TikTok (app/v3).\n\n### Purpose:\n- Get user repost video data\n### Parameters:\n- user_id: User id, which can be obtained through the handler_user_profile endpoint, with the keyword uid in the response.\n- offset: Offset\n- count: Number\n### Return:\n- User repost video data\n\nAPI references: `handler_user_profile` = `GET /tikhub/tiktok/app/v3/handler_user_profile` (operationId: `get_tikhub_tiktok_app_v3_handler_user_profile`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_app_v3_fetch_user_repost_videos", "responses": { "200": { "description": "Successful Response\n\n### Return\n- User repost video data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_user_repost_videos", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "cbae4b570aa4" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/app/v3/fetch_user_repost_videos", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_app_v3_fetch_user_repost_videos", "method": "GET", "path": "/apis/v1/tikhub/tiktok/app/v3/fetch_user_repost_videos" }, "parameters": [ { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number", "default": 21, "title": "Count" }, "description": "Number" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "description": "Offset", "default": 0, "title": "Offset" }, "description": "Offset" }, { "name": "user_id", "in": "query", "required": true, "schema": { "type": "integer", "description": "User id, which can be obtained through the handler_user_profile endpoint, with the keyword uid in the response.\n\nAPI references: `handler_user_profile` = `GET /tikhub/tiktok/app/v3/handler_user_profile` (operationId: `get_tikhub_tiktok_app_v3_handler_user_profile`).", "title": "User Id" }, "description": "User id, which can be obtained through the handler_user_profile endpoint, with the keyword uid in the response.\n\nAPI references: `handler_user_profile` = `GET /tikhub/tiktok/app/v3/handler_user_profile` (operationId: `get_tikhub_tiktok_app_v3_handler_user_profile`).", "example": 107955 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:67c5c47142e0b7b20807015bd70bdd10aabe10723ed2c25a9e086eafca9471d0" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/app/v3/fetch_user_repost_videos?user_id=107955' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-app-v3-fetch_user_repost_videos" } }, "/apis/v1/tikhub/tiktok/app/v3/fetch_user_search_result": { "get": { "description": "TikTok (app/v3).\n\n### Purpose:\n- Get user search results of specified keywords\n### Parameters:\n- keyword: Keyword\n- offset: Offset\n- count: Number\n- user_search_follower_count（Sort by number of followers）:\n - Empty-Unlimited,\n - ZERO_TO_ONE_K = 0-1K,\n - ONE_K_TO_TEN_K-1K = 1K-10K,\n - TEN_K_TO_ONE_H_K = 10K-100K,\n - ONE_H_K_PLUS = 100K and above\n- user_search_profile_type（Sort by account type）:\n - Empty-Unlimited,\n - VERIFIED = Verified user\n- user_search_other_pref（Sort by other preferences）:\n - USERNAME = Sort by username relevance\n### Return:\n- User search results\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_app_v3_fetch_user_search_result", "responses": { "200": { "description": "Successful Response\n\n### Return\n- User search results", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_user_search_result", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "dd431cbdfe25" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/app/v3/fetch_user_search_result", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_app_v3_fetch_user_search_result", "method": "GET", "path": "/apis/v1/tikhub/tiktok/app/v3/fetch_user_search_result" }, "parameters": [ { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number", "default": 20, "title": "Count" }, "description": "Number", "example": 20 }, { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Keyword", "title": "Keyword" }, "description": "Keyword", "example": "Cat" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "description": "Offset", "default": 0, "title": "Offset" }, "description": "Offset", "example": 0 }, { "name": "user_search_follower_count", "in": "query", "required": false, "schema": { "type": "string", "description": "Sort by number of followers", "default": "", "title": "User Search Follower Count" }, "description": "Sort by number of followers", "example": "" }, { "name": "user_search_other_pref", "in": "query", "required": false, "schema": { "type": "string", "description": "Sort by other preferences", "default": "", "title": "User Search Other Pref" }, "description": "Sort by other preferences", "example": "" }, { "name": "user_search_profile_type", "in": "query", "required": false, "schema": { "type": "string", "description": "Sort by account type", "default": "", "title": "User Search Profile Type" }, "description": "Sort by account type", "example": "" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:87957dfeb558eaa47b87820647a96803891e53d04448162cafc3cdb256cb0f16" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/app/v3/fetch_user_search_result?count=20&keyword=Cat&offset=0&user_search_follower_count=&user_search_other_pref=&user_search_profile_type=' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-app-v3-fetch_user_search_result" } }, "/apis/v1/tikhub/tiktok/app/v3/fetch_video_comment_replies": { "get": { "description": "TikTok (app/v3).\n\n### Purpose:\n- Get comment replies data of specified video\n### Parameters:\n- item_id: Video id\n- comment_id: Comment id\n- cursor: Cursor, used for paging, the first page is 0, the second page is the cursor value in the first response.\n- count: Number\n### Return:\n- Comment replies data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_app_v3_fetch_video_comment_replies", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Comment replies data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_video_comment_replies", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "ed9403fc6b5c" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/app/v3/fetch_video_comment_replies", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_app_v3_fetch_video_comment_replies", "method": "GET", "path": "/apis/v1/tikhub/tiktok/app/v3/fetch_video_comment_replies" }, "parameters": [ { "name": "comment_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Comment id", "title": "Comment Id" }, "description": "Comment id", "example": "7327061675382260482" }, { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number", "default": 20, "title": "Count" }, "description": "Number" }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "integer", "description": "Cursor, used for paging, the first page is 0, the second page is the cursor value in the first response.", "default": 0, "title": "Cursor" }, "description": "Cursor, used for paging, the first page is 0, the second page is the cursor value in the first response." }, { "name": "item_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Video id", "title": "Item Id" }, "description": "Video id", "example": "7326156045968067873" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:9a677f323913fd85e044b82a9e4202df4a2ab75a4eff43281a010ee2d0bc9dc9" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/app/v3/fetch_video_comment_replies?comment_id=7327061675382260482&item_id=7326156045968067873' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-app-v3-fetch_video_comment_replies" } }, "/apis/v1/tikhub/tiktok/app/v3/fetch_video_comments": { "get": { "description": "TikTok (app/v3).\n\n### Purpose:\n- Get single video comments data\n### Parameters:\n- aweme_id: Video id\n- cursor: Cursor, used for paging, the first page is 0, the second page is the cursor value in the first response.\n- count: Number\n### Return:\n- Comments data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_app_v3_fetch_video_comments", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Comments data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_video_comments", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "9ca3ca6141cf" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/app/v3/fetch_video_comments", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_app_v3_fetch_video_comments", "method": "GET", "path": "/apis/v1/tikhub/tiktok/app/v3/fetch_video_comments" }, "parameters": [ { "name": "aweme_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Video id", "title": "Aweme Id" }, "description": "Video id", "example": "7326156045968067873" }, { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number", "default": 20, "title": "Count" }, "description": "Number" }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "integer", "description": "Cursor, used for paging, the first page is 0, the second page is the cursor value in the first response.", "default": 0, "title": "Cursor" }, "description": "Cursor, used for paging, the first page is 0, the second page is the cursor value in the first response." } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:ba0b022bed3baa2ae848869b2620b5a0dc659cd8b700d13c7fe3969d42c9ca27" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/app/v3/fetch_video_comments?aweme_id=7326156045968067873' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-app-v3-fetch_video_comments" } }, "/apis/v1/tikhub/tiktok/app/v3/fetch_video_search_result": { "get": { "description": "TikTok (app/v3).\n\n### Purpose:\n- Get video search results of specified keywords\n### Parameters:\n- keyword: Keyword\n- offset: Offset\n- count: Number\n- sort_type: 0-Relatedness, 1-Most likes\n- publish_time: 0-Unlimited, 1-Last day, 7-Last week, 30-Last month, 90-Last three months, 180-Last half year\n- region: Region, default is US-America, for optional values please refer to TikTok region codes or ISO 3166-1 alpha-2 country codes.\n### Return:\n- Video search results\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_app_v3_fetch_video_search_result", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Video search results", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_video_search_result", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "b23ddb7d0ecc" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/app/v3/fetch_video_search_result", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_app_v3_fetch_video_search_result", "method": "GET", "path": "/apis/v1/tikhub/tiktok/app/v3/fetch_video_search_result" }, "parameters": [ { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number", "default": 20, "title": "Count" }, "description": "Number", "example": 20 }, { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Keyword", "title": "Keyword" }, "description": "Keyword", "example": "Zhonghua Niang" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "description": "Offset", "default": 0, "title": "Offset" }, "description": "Offset", "example": 0 }, { "name": "publish_time", "in": "query", "required": false, "schema": { "type": "integer", "description": "Publish time\n\nUsage: 0-Unlimited, 1-Last day, 7-Last week, 30-Last month, 90-Last three months, 180-Last half year", "default": 0, "title": "Publish Time" }, "description": "Publish time\n\nUsage: 0-Unlimited, 1-Last day, 7-Last week, 30-Last month, 90-Last three months, 180-Last half year", "example": 0 }, { "name": "region", "in": "query", "required": false, "schema": { "type": "string", "description": "Region, default is US-America, for optional values please refer to TikTok region codes or ISO 3166-1 alpha-2 country codes.", "default": "US", "title": "Region" }, "description": "Region, default is US-America, for optional values please refer to TikTok region codes or ISO 3166-1 alpha-2 country codes.", "example": "US" }, { "name": "sort_type", "in": "query", "required": false, "schema": { "type": "integer", "description": "Sort type\n\nUsage: 0-Relatedness, 1-Most likes", "default": 0, "title": "Sort Type" }, "description": "Sort type\n\nUsage: 0-Relatedness, 1-Most likes", "example": 0 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:d40854a0b102e98289dcc39543a2fa6f35b2593e52251c3a33b113449b36741b" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/app/v3/fetch_video_search_result?count=20&keyword=Zhonghua+Niang&offset=0&publish_time=0®ion=US&sort_type=0' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-app-v3-fetch_video_search_result" } }, "/apis/v1/tikhub/tiktok/app/v3/fetch_webcast_user_info": { "get": { "description": "TikTok (app/v3).\n\n### Purpose:\n- Get information of specified user\n### Parameters:\n- sec_user_id: User sec_user_id\n- user_id: User uid, optional parameter, pure number, if used, please keep sec_user_id and unique_id empty.\n- At least one of the above parameters must be filled in, the priority is sec_user_id > user_id, the higher the priority, the faster the speed.\n### Return:\n- User information\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_app_v3_fetch_webcast_user_info", "responses": { "200": { "description": "Successful Response\n\n### Return\n- User information", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_webcast_user_info", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "b0e1678ed1fe" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/app/v3/fetch_webcast_user_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_app_v3_fetch_webcast_user_info", "method": "GET", "path": "/apis/v1/tikhub/tiktok/app/v3/fetch_webcast_user_info" }, "parameters": [ { "name": "sec_user_id", "in": "query", "required": false, "schema": { "type": "string", "description": "User sec_user_id", "default": "", "title": "Sec User Id" }, "description": "User sec_user_id", "example": "MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM" }, { "name": "user_id", "in": "query", "required": false, "schema": { "type": "string", "description": "User uid (optional, numeric only)\n\nUsage: User uid, optional parameter, pure number, if used, please keep sec_user_id and unique_id empty.", "default": "", "title": "User Id" }, "description": "User uid (optional, numeric only)\n\nUsage: User uid, optional parameter, pure number, if used, please keep sec_user_id and unique_id empty.", "example": "" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:4ced81916d3a065d67730a502526901ce6b14ead6029b1fe45962771f9e57926" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-app-v3-fetch_webcast_user_info" } }, "/apis/v1/tikhub/tiktok/app/v3/get_user_id_and_sec_user_id_by_username": { "get": { "description": "TikTok (app/v3).\n\n### Purpose:\n- Get user_id and sec_user_id by Username\n### Parameters:\n- username: Username\n### Return:\n- User user_id and sec_user_id\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_app_v3_get_user_id_and_sec_user_id_by_username", "responses": { "200": { "description": "Successful Response\n\n### Return\n- User user_id and sec_user_id", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok get_user_id_and_sec_user_id_by_username", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "cccc1ff79948" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/app/v3/get_user_id_and_sec_user_id_by_username", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_app_v3_get_user_id_and_sec_user_id_by_username", "method": "GET", "path": "/apis/v1/tikhub/tiktok/app/v3/get_user_id_and_sec_user_id_by_username" }, "parameters": [ { "name": "username", "in": "query", "required": true, "schema": { "type": "string", "description": "Username", "title": "Username" }, "description": "Username", "example": "tiktok" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:476abf58d39a69773612d8c407a6a5db137fe5902cbb5f4b12fecc65abc7c131" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/app/v3/get_user_id_and_sec_user_id_by_username?username=tiktok' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-app-v3-get_user_id_and_sec_user_id_by_username" } }, "/apis/v1/tikhub/tiktok/app/v3/handler_user_profile": { "get": { "description": "TikTok (app/v3).\n\n### Purpose:\n- Get information of specified user\n### Parameters:\n- sec_user_id: User sec_user_id\n- user_id: User uid, optional parameter, pure number, if used, please keep sec_user_id and unique_id empty.\n- unique_id: User unique_id, optional parameter, if sec_user_id is empty, use unique_id to get user information, unique_id is also the user's username, if used, please keep sec_user_id and user_id empty.\n- At least one of the above parameters must be filled in, the priority is sec_user_id > user_id > unique_id, the higher the priority, the faster the speed.\n### Return:\n- User information\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_app_v3_handler_user_profile", "responses": { "200": { "description": "Successful Response\n\n### Return\n- User information", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok handler_user_profile", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "8b423862b619" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/app/v3/handler_user_profile", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_app_v3_handler_user_profile", "method": "GET", "path": "/apis/v1/tikhub/tiktok/app/v3/handler_user_profile" }, "parameters": [ { "name": "sec_user_id", "in": "query", "required": false, "schema": { "type": "string", "description": "User sec_user_id", "default": "", "title": "Sec User Id" }, "description": "User sec_user_id", "example": "MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM" }, { "name": "unique_id", "in": "query", "required": false, "schema": { "type": "string", "description": "User unique_id, optional parameter, if sec_user_id is empty, use unique_id to get user information, unique_id is also the user's username, if used, please keep sec_user_id and user_id empty.", "default": "", "title": "Unique Id" }, "description": "User unique_id, optional parameter, if sec_user_id is empty, use unique_id to get user information, unique_id is also the user's username, if used, please keep sec_user_id and user_id empty.", "example": "" }, { "name": "user_id", "in": "query", "required": false, "schema": { "type": "string", "description": "User uid (optional, numeric only)\n\nUsage: User uid, optional parameter, pure number, if used, please keep sec_user_id and unique_id empty.", "default": "", "title": "User Id" }, "description": "User uid (optional, numeric only)\n\nUsage: User uid, optional parameter, pure number, if used, please keep sec_user_id and unique_id empty.", "example": "" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:4ced81916d3a065d67730a502526901ce6b14ead6029b1fe45962771f9e57926" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-app-v3-handler_user_profile" } }, "/apis/v1/tikhub/tiktok/app/v3/open_tiktok_app_to_keyword_search": { "get": { "description": "TikTok (app/v3).\n\n### Purpose:\n- Generate TikTok share link, call TikTok APP, and jump to the specified keyword search result\n\n### Parameters:\n- keyword: Keyword\n- Note: If you cannot jump, please make sure that the APP is running in the background\n\n### Return:\n- Share link\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_app_v3_open_tiktok_app_to_keyword_search", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Share link", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok open_tiktok_app_to_keyword_search", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "3ebbb1fa4db1" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/app/v3/open_tiktok_app_to_keyword_search", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_app_v3_open_tiktok_app_to_keyword_search", "method": "GET", "path": "/apis/v1/tikhub/tiktok/app/v3/open_tiktok_app_to_keyword_search" }, "parameters": [ { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Keyword", "title": "Keyword" }, "description": "Keyword", "example": "Evil0ctal" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:3f7749f8035dd84b9fb1d9d72924d486835e8a8ec83953a93308318a19fc66e6" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/app/v3/open_tiktok_app_to_keyword_search?keyword=Evil0ctal' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-app-v3-open_tiktok_app_to_keyword_search" } }, "/apis/v1/tikhub/tiktok/app/v3/open_tiktok_app_to_send_private_message": { "get": { "description": "TikTok (app/v3).\n\n### Purpose:\n- Generate TikTok share link, call TikTok APP, and send private messages to specified users\n\n### Parameters:\n- uid: User id, obtained from the user profile interface.\n- Note: If you cannot jump, please make sure that the APP is running in the background.\n\n### Return:\n- Share link\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_app_v3_open_tiktok_app_to_send_private_message", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Share link", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok open_tiktok_app_to_send_private_message", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "50240bef9458" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/app/v3/open_tiktok_app_to_send_private_message", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_app_v3_open_tiktok_app_to_send_private_message", "method": "GET", "path": "/apis/v1/tikhub/tiktok/app/v3/open_tiktok_app_to_send_private_message" }, "parameters": [ { "name": "uid", "in": "query", "required": true, "schema": { "type": "string", "description": "User id, obtained from the user profile interface.", "title": "Uid" }, "description": "User id, obtained from the user profile interface.", "example": "7059867056504407087" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:3f7749f8035dd84b9fb1d9d72924d486835e8a8ec83953a93308318a19fc66e6" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/app/v3/open_tiktok_app_to_send_private_message?uid=7059867056504407087' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-app-v3-open_tiktok_app_to_send_private_message" } }, "/apis/v1/tikhub/tiktok/app/v3/open_tiktok_app_to_user_profile": { "get": { "description": "TikTok (app/v3).\n\n### Purpose:\n- Generate TikTok share link, call TikTok APP, and jump to the specified user profile\n\n### Parameters:\n- uid: User id, obtained from the user profile interface.\n- Note: If you cannot jump, please make sure that the APP is running in the background.\n\n### Return:\n- Share link\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_app_v3_open_tiktok_app_to_user_profile", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Share link", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok open_tiktok_app_to_user_profile", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "491181552929" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/app/v3/open_tiktok_app_to_user_profile", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_app_v3_open_tiktok_app_to_user_profile", "method": "GET", "path": "/apis/v1/tikhub/tiktok/app/v3/open_tiktok_app_to_user_profile" }, "parameters": [ { "name": "uid", "in": "query", "required": true, "schema": { "type": "string", "description": "User id, obtained from the user profile interface.", "title": "Uid" }, "description": "User id, obtained from the user profile interface.", "example": "7059867056504407087" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:3f7749f8035dd84b9fb1d9d72924d486835e8a8ec83953a93308318a19fc66e6" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/app/v3/open_tiktok_app_to_user_profile?uid=7059867056504407087' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-app-v3-open_tiktok_app_to_user_profile" } }, "/apis/v1/tikhub/tiktok/app/v3/open_tiktok_app_to_video_detail": { "get": { "description": "TikTok (app/v3).\n\n### Purpose:\n- Generate TikTok share link, call TikTok APP, and jump to the specified video\n\n### Parameters:\n- aweme_id: Video id\n- Note: If you cannot jump, please make sure that the APP is running in the background\n\n### Return:\n- Share link\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_app_v3_open_tiktok_app_to_video_detail", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Share link", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok open_tiktok_app_to_video_detail", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "d12354904992" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/app/v3/open_tiktok_app_to_video_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_app_v3_open_tiktok_app_to_video_detail", "method": "GET", "path": "/apis/v1/tikhub/tiktok/app/v3/open_tiktok_app_to_video_detail" }, "parameters": [ { "name": "aweme_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Video id", "title": "Aweme Id" }, "description": "Video id", "example": "7440436579409153311" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:3f7749f8035dd84b9fb1d9d72924d486835e8a8ec83953a93308318a19fc66e6" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/app/v3/open_tiktok_app_to_video_detail?aweme_id=7440436579409153311' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-app-v3-open_tiktok_app_to_video_detail" } }, "/apis/v1/tikhub/tiktok/app/v3/search_follower_list": { "get": { "description": "TikTok (app/v3).\n\n### Purpose:\n- Search follower list of specified user, can be used to find whether there is a user with a specific nickname in the followers of a certain user.\n### Parameters:\n- user_id: User ID, this is a pure numeric version of the user ID, which can be obtained through the get user info API.\n- keyword: Search keyword, the user's nickname contains the keyword to match.\n### Return:\n- Search result list\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_app_v3_search_follower_list", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Search result list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok search_follower_list", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "5163edef0454" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/app/v3/search_follower_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_app_v3_search_follower_list", "method": "GET", "path": "/apis/v1/tikhub/tiktok/app/v3/search_follower_list" }, "parameters": [ { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Search keyword, the user's nickname contains the keyword to match.", "title": "Keyword" }, "description": "Search keyword, the user's nickname contains the keyword to match.", "example": "a" }, { "name": "user_id", "in": "query", "required": true, "schema": { "type": "string", "description": "User ID, this is a pure numeric version of the user ID, which can be obtained through the get user info API.", "title": "User Id" }, "description": "User ID, this is a pure numeric version of the user ID, which can be obtained through the get user info API.", "example": "7540849481009988663" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:cb70de961d2b644841e4ae8e6b59f29e483f76c9be115fca7d01665e7390f154" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/app/v3/search_follower_list?keyword=a&user_id=7540849481009988663' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-app-v3-search_follower_list" } }, "/apis/v1/tikhub/tiktok/app/v3/search_following_list": { "get": { "description": "TikTok (app/v3).\n\n### Purpose:\n- Search following list of specified user, can be used to find whether there is a user with a specific nickname in the following of a certain user.\n### Parameters:\n- user_id: User ID, this is a pure numeric version of the user ID, which can be obtained through the get user info API.\n- keyword: Search keyword, the user's nickname contains the keyword to match.\n### Return:\n- Search result list\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_app_v3_search_following_list", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Search result list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok search_following_list", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "aae522ed7075" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/app/v3/search_following_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_app_v3_search_following_list", "method": "GET", "path": "/apis/v1/tikhub/tiktok/app/v3/search_following_list" }, "parameters": [ { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Search keyword, the user's nickname contains the keyword to match.", "title": "Keyword" }, "description": "Search keyword, the user's nickname contains the keyword to match.", "example": "a" }, { "name": "user_id", "in": "query", "required": true, "schema": { "type": "string", "description": "User ID, this is a pure numeric version of the user ID, which can be obtained through the get user info API.", "title": "User Id" }, "description": "User ID, this is a pure numeric version of the user ID, which can be obtained through the get user info API.", "example": "7540849481009988663" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:cb70de961d2b644841e4ae8e6b59f29e483f76c9be115fca7d01665e7390f154" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/app/v3/search_following_list?keyword=a&user_id=7540849481009988663' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-app-v3-search_following_list" } }, "/apis/v1/tikhub/tiktok/creator/get_account_health_status": { "post": { "description": "TikTok (creator).\n\n### Purpose:\n- Retrieve the health status of a TikTok Shop creator account, including the health score over the past 90 days and the current number of accumulated violation points.\n- About violation points:\n - Violation points are key metrics used by TikTok to measure the health of a creator account.\n - Higher violation points indicate worse account health, and may lead to restrictions such as reduced exposure, suspension, or account bans.\n - Violation points directly impact the account’s visibility and recommendation on the platform.\n\n### Punishment Levels for Accumulated Violation Points:\n| Score Range | Punishment Measures | Duration |\n| ----------- | ---------------------------------------------------------- | ---------------- |\n| 9-11 | Warning | None |\n| 12-14 | E-commerce permissions suspended (video, live, product showcase) | 24 hours |\n| 15-17 | E-commerce permissions suspended | 48 hours |\n| 18-20 | E-commerce permissions suspended | 72 hours |\n| 21-23 | E-commerce permissions suspended | 1 week |\n| 24+ | Permanent removal of e-commerce permissions and banning of TikTok Shop creator account | Permanently disabled |\n\n### Notes:\n- This API is only applicable to TikTok Shop creator accounts.\n\n### Parameters:\n- cookie: User Cookie string for authentication\n- proxy: Optional HTTP proxy address, can be omitted if not needed\n - Example format: `http://username:password@host:port`\n\n### Response:\n- `risk_info`: Account health status:\n - `risk_level_text`: Current health level description (e.g., Healthy)\n - `light_color`: Light color code for health level display (RGBA format)\n - `dark_color`: Dark color code for health level display (RGBA format)\n- `vio_score_rule_learn_url`: URL to learn more about violation point rules\n- `is_show_score`: Whether to display violation points (boolean)\n- `violation_score`: Current violation score\n- `creator_status`: Creator account status code (0 = normal)\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_tiktok_creator_get_account_health_status", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Response\n- `risk_info`: Account health status:\n - `risk_level_text`: Current health level description (e.g., Healthy)\n - `light_color`: Light color code for health level display (RGBA format)\n - `dark_color`: Dark color code for health level display (RGBA format)\n- `vio_score_rule_learn_url`: URL to learn more about violation point rules\n- `is_show_score`: Whether to display violation points (boolean)\n- `violation_score`: Current violation score\n- `creator_status`: Creator account status code (0 = normal)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok get_account_health_status", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "26346639cd09" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/creator/get_account_health_status", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_tiktok_creator_get_account_health_status", "method": "POST", "path": "/apis/v1/tikhub/tiktok/creator/get_account_health_status" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User Cookie String", "default": "Your_Cookie_String" }, "proxy": { "title": "Proxy", "description": "Optional HTTP proxy address, can be omitted if not needed\n - Example format: `http://username:password@host:port`", "default": "", "type": [ "string", "null" ] } }, "type": "object", "title": "GetAccountHealthRequest" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:ee802e8148c8e0634cc6e9961dba1ea6864715bd7e5a00960c2216a596690d66" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-tiktok-creator-get_account_health_status" } }, "/apis/v1/tikhub/tiktok/creator/get_account_insights_overview": { "post": { "description": "TikTok (creator).\n\n### Purpose:\n- Retrieve performance overview of a TikTok Shop creator account within a specified date range, including metrics like revenue, exposure, clicks, and orders.\n- By default, it aggregates data from the month of `start_date` (e.g., if `start_date` is 2025-04-01, it retrieves data for the entire month of April).\n\n### Notes:\n- This API is only applicable to TikTok accounts that have TikTok Shop enabled.\n- Data is segmented by time granularity (daily/monthly), and can be used for performance analysis or trend monitoring.\n\n### Parameters:\n- cookie: User cookie string for authentication\n- start_date: Query start date in 'MM-DD-YYYY' format, e.g. '04-01-2025'\n- proxy: Optional HTTP proxy address. Leave empty if not needed.\n - Example format: `http://username:password@host:port`\n\n### Response:\n- `segments`: List of data segments, each containing:\n - `time_selector`: Time settings for the segment, including period, timestamp range, timezone, and locale\n - `timed_stats`: Daily or interval-based statistics, including:\n - `live_revenue.amount`: Revenue from livestream sales\n - `video_revenue.amount`: Revenue from video sales\n - `revenue.amount`: Total revenue (live + video)\n - `base_revenue.amount`: Base revenue\n - `commission_estimated.amount`: Estimated commission\n - `alc_base_revenue.amount`: Base revenue under ALC model\n - `overall_item_sold_cnt`: Total items sold\n - `product_show_cnt`: Product exposure count\n - `product_click_cnt`: Product click count\n - `alc_pay_sku_order_cnt`: Orders under ALC model\n- `meta.is_bound_shop`: Whether the TikTok account is bound to a shop\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_tiktok_creator_get_account_insights_overview", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Response\n- `segments`: List of data segments, each containing:\n - `time_selector`: Time settings for the segment, including period, timestamp range, timezone, and locale\n - `timed_stats`: Daily or interval-based statistics, including:\n - `live_revenue.amount`: Revenue from livestream sales\n - `video_revenue.amount`: Revenue from video sales\n - `revenue.amount`: Total revenue (live + video)\n - `base_revenue.amount`: Base revenue\n - `commission_estimated.amount`: Estimated commission\n - `alc_base_revenue.amount`: Base revenue under ALC model\n - `overall_item_sold_cnt`: Total items sold\n - `product_show_cnt`: Product exposure count\n - `product_click_cnt`: Product click count\n - `alc_pay_sku_order_cnt`: Orders under ALC model\n- `meta.is_bound_shop`: Whether the TikTok account is bound to a shop", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok get_account_insights_overview", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "6986495f1182" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/creator/get_account_insights_overview", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_tiktok_creator_get_account_insights_overview", "method": "POST", "path": "/apis/v1/tikhub/tiktok/creator/get_account_insights_overview" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User Cookie String", "default": "Your_Cookie_String" }, "proxy": { "title": "Proxy", "description": "Optional HTTP proxy address. Leave empty if not needed.\n - Example format: `http://username:password@host:port`", "default": "", "type": [ "string", "null" ] }, "start_date": { "type": "string", "title": "Start Date", "description": "Query Start Date, e.g. '04-01-2025'", "default": "04-01-2025" } }, "type": "object", "title": "GetAccountOverviewRequest" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:deff5c8c3e0749bb0fc4673daa3c798fcd20282b5e7dd64af76904cb201ef4dd" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-tiktok-creator-get_account_insights_overview" } }, "/apis/v1/tikhub/tiktok/creator/get_account_violation_list": { "post": { "description": "TikTok (creator).\n\n### Purpose:\n- Retrieve the violation history of a TikTok Shop creator account, providing details about past violations and corresponding enforcement actions.\n- The returned violation records include violation type, violation time, violation reasons, enforcement actions, appeal status, and eligibility for appeal.\n- Pagination is supported to retrieve multiple records in chronological order.\n- Suitable for creator account risk management, health monitoring, and compliance auditing.\n\n### Notes:\n- This API is available only for TikTok Shop creator accounts.\n- Pagination is supported; by default, it retrieves the latest violation records.\n\n### Parameters:\n- cookie: User's Cookie string for authentication\n- page: Integer, page number (default is `1`)\n- proxy: Optional HTTP proxy address, can be omitted if not needed\n - Example format: `http://username:password@host:port`\n\n### Response:\n- `records`: List of violation records:\n - `record_id`: Unique ID of the violation record\n - `violation_time`: Time when the violation occurred (Unix timestamp)\n - `violation_info`:\n - `violation_reason`: Reason for the violation\n - `violation_detail`: Detailed description (may be empty)\n - `violation_suggestion`: Recommended corrective action\n - `policy_url`: Link to the related policy\n - `violation_type`: Type of violation (e.g., Video violation)\n - `record_status`: Record status (1 = active)\n - `appeal_status`: Appeal status (0 = not appealed, 1 = appealed)\n - `enforcement_title`: List of enforcement actions taken (e.g., point assignment, commission withholding)\n - `appeal_valid_time`: Deadline for submitting an appeal (Unix timestamp)\n - `can_appeal`: Whether the record is eligible for appeal (boolean)\n- `total`: Total number of violation records\n- `has_more`: Whether there are more records to fetch\n- `start_time`: Query start time\n- `end_time`: Query end time\n- `creator_status`: Creator account status code (e.g., 0 = normal)\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_tiktok_creator_get_account_violation_list", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Response\n- `records`: List of violation records:\n - `record_id`: Unique ID of the violation record\n - `violation_time`: Time when the violation occurred (Unix timestamp)\n - `violation_info`:\n - `violation_reason`: Reason for the violation\n - `violation_detail`: Detailed description (may be empty)\n - `violation_suggestion`: Recommended corrective action\n - `policy_url`: Link to the related policy\n - `violation_type`: Type of violation (e.g., Video violation)\n - `record_status`: Record status (1 = active)\n - `appeal_status`: Appeal status (0 = not appealed, 1 = appealed)\n - `enforcement_title`: List of enforcement actions taken (e.g., point assignment, commission withholding)\n - `appeal_valid_time`: Deadline for submitting an appeal (Unix timestamp)\n - `can_appeal`: Whether the record is eligible for appeal (boolean)\n- `total`: Total number of violation records\n- `has_more`: Whether there are more records to fetch\n- `start_time`: Query start time\n- `end_time`: Query end time\n- `creator_status`: Creator account status code (e.g., 0 = normal)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok get_account_violation_list", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "1fc566f91531" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/creator/get_account_violation_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_tiktok_creator_get_account_violation_list", "method": "POST", "path": "/apis/v1/tikhub/tiktok/creator/get_account_violation_list" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User Cookie String", "default": "Your_Cookie_String" }, "proxy": { "title": "Proxy", "description": "Optional HTTP proxy address, can be omitted if not needed\n - Example format: `http://username:password@host:port`", "default": "", "type": [ "string", "null" ] }, "page": { "type": "integer", "title": "Page", "description": "Integer, page number (default is `1`)", "default": 1 } }, "type": "object", "title": "GetViolationRecordRequest" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e2d20d82b07f3de10c2039f7bee2899020a55b76f4a4e396b27bda6896167989" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-tiktok-creator-get_account_violation_list" } }, "/apis/v1/tikhub/tiktok/creator/get_creator_account_info": { "post": { "description": "TikTok (creator).\n\n### Purpose:\n- Retrieve basic information of a TikTok Shop creator account, including username, avatar URLs, account ID, register region, partner binding info, and permission list.\n- Useful for verifying account status, displaying user profile data, checking partner binding status, and determining access permissions for business processes.\n\n### Notes:\n- Applicable to all TikTok creator accounts.\n\n### Parameters:\n- cookie: User Cookie string for authentication\n- proxy: Optional HTTP proxy address, can be omitted if not used\n - Example format: `http://username:password@host:port`\n\n### Return Content Description:\n- `user_id`: User ID (string)\n- `user_type`: User type (integer, indicates account type)\n- `register_region_id`: Registered region code (e.g., \"us\")\n- `user_name`: Username\n- `avatar`: Avatar info object\n - `uri`: Avatar resource URI\n - `url_list`: List of avatar image URLs\n- `permission_list`: Permission list (list of integers)\n- `partner_id`: Partner ID\n- `partner_name`: Partner name\n- `shop_account_official`: Whether it's an official shop account (boolean)\n- `switch_info`: Feature switch info (e.g., live event switch, string format)\n- `tt_uid`: TikTok UID (string)\n- `nick_name`: Nickname\n- `live_streamer_menu_experiment`: Live streamer menu experiment field (string, may be empty)\n- `experiment_variants`: Experiment variant configurations (object)\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_tiktok_creator_get_creator_account_info", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return Content Description\n- `user_id`: User ID (string)\n- `user_type`: User type (integer, indicates account type)\n- `register_region_id`: Registered region code (e.g., \"us\")\n- `user_name`: Username\n- `avatar`: Avatar info object\n - `uri`: Avatar resource URI\n - `url_list`: List of avatar image URLs\n- `permission_list`: Permission list (list of integers)\n- `partner_id`: Partner ID\n- `partner_name`: Partner name\n- `shop_account_official`: Whether it's an official shop account (boolean)\n- `switch_info`: Feature switch info (e.g., live event switch, string format)\n- `tt_uid`: TikTok UID (string)\n- `nick_name`: Nickname\n- `live_streamer_menu_experiment`: Live streamer menu experiment field (string, may be empty)\n- `experiment_variants`: Experiment variant configurations (object)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok get_creator_account_info", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a4afa0133dd7" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/creator/get_creator_account_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_tiktok_creator_get_creator_account_info", "method": "POST", "path": "/apis/v1/tikhub/tiktok/creator/get_creator_account_info" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User Cookie String", "default": "Your_Cookie_String" }, "proxy": { "title": "Proxy", "description": "Optional HTTP proxy address, can be omitted if not used\n - Example format: `http://username:password@host:port`", "default": "", "type": [ "string", "null" ] } }, "type": "object", "title": "GetCreatorAccountInfoRequest" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:3c07facdbeb6ac3cdfd809ac7fb97a1aa488efbac042929fb4afd7483214a804" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-tiktok-creator-get_creator_account_info" } }, "/apis/v1/tikhub/tiktok/creator/get_live_analytics_summary": { "post": { "description": "TikTok (creator).\n\n### Purpose:\n- Retrieve a summary of live streaming performance for a TikTok Shop creator account within a specified time range.\n- By default, it covers one full calendar month starting from the provided `start_date` (e.g., input `04-01-2025` will fetch data for the entire April 2025).\n\n### Response Fields:\n- `segments` (List of segmented data):\n - `time_selector`: Time period settings (period, start/end timestamps, timezone, locale)\n - `filter.creator_id`: Creator ID\n - `timed_stats`: Live performance statistics per time segment, including:\n - `live_revenue.amount`: Live streaming revenue\n - `live_show_gpm.amount`: Average revenue per live show\n - `new_follower_cnt`: Number of new followers\n - `sku_order_paid_cnt`: Number of SKUs paid\n - `item_sold_cnt`: Number of items sold\n - `product_view`: Number of product views\n - `product_click`: Number of product clicks\n - `live_pay_order_ucnt`: Number of unique users who placed live orders\n - `live_ctr`: Live Click-Through Rate (CTR)\n - `live_co`: Live Conversion Rate (CO)\n - `live_like_cnt`: Number of live likes\n - `live_comment_cnt`: Number of live comments\n - `live_show_cnt`: Number of live sessions\n - `live_watch_cnt`: Number of live viewers\n\n### Notes:\n- This API is only applicable to TikTok Shop creator accounts.\n- Data is split by natural days during the live sessions.\n\n### Parameters:\n- cookie: User Cookie string for authentication\n- start_date: Query start date in the format `MM-DD-YYYY`, e.g., `04-01-2025`\n- proxy: Optional HTTP proxy address, can be omitted if not used\n - Example format: `http://username:password@host:port`\n\n### Return:\n- Creator live streaming performance overview\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_tiktok_creator_get_live_analytics_summary", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Response Fields\n- `segments` (List of segmented data):\n - `time_selector`: Time period settings (period, start/end timestamps, timezone, locale)\n - `filter.creator_id`: Creator ID\n - `timed_stats`: Live performance statistics per time segment, including:\n - `live_revenue.amount`: Live streaming revenue\n - `live_show_gpm.amount`: Average revenue per live show\n - `new_follower_cnt`: Number of new followers\n - `sku_order_paid_cnt`: Number of SKUs paid\n - `item_sold_cnt`: Number of items sold\n - `product_view`: Number of product views\n - `product_click`: Number of product clicks\n - `live_pay_order_ucnt`: Number of unique users who placed live orders\n - `live_ctr`: Live Click-Through Rate (CTR)\n - `live_co`: Live Conversion Rate (CO)\n - `live_like_cnt`: Number of live likes\n - `live_comment_cnt`: Number of live comments\n - `live_show_cnt`: Number of live sessions\n - `live_watch_cnt`: Number of live viewers\n\n### Return\n- Creator live streaming performance overview", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok get_live_analytics_summary", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "033a6daf7957" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/creator/get_live_analytics_summary", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_tiktok_creator_get_live_analytics_summary", "method": "POST", "path": "/apis/v1/tikhub/tiktok/creator/get_live_analytics_summary" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User Cookie String", "default": "Your_Cookie_String" }, "proxy": { "title": "Proxy", "description": "Optional HTTP proxy address, can be omitted if not used\n - Example format: `http://username:password@host:port`", "default": "", "type": [ "string", "null" ] }, "start_date": { "type": "string", "title": "Start Date", "description": "Query start date in the format `MM-DD-YYYY`, e.g., `04-01-2025`", "default": "04-01-2025" } }, "type": "object", "title": "GetLiveOverviewRequest" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:ffe72a1f70fcba2a91360b1f73c19ffb769718d6cf7029ae370324675ebda572" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-tiktok-creator-get_live_analytics_summary" } }, "/apis/v1/tikhub/tiktok/creator/get_product_analytics_list": { "post": { "description": "TikTok (creator).\n\n### Purpose:\n- Retrieve the list of products promoted by a TikTok Shop creator account within a specified time range, along with their sales analytics.\n- Supports sorting by revenue or product publish time and allows pagination.\n\n### Response Fields:\n- `segments` (List of segmented data):\n - `filter.creator_id`: Creator account ID\n - `list_control`:\n - `rules`: Sorting rules (e.g., by revenue, by product ID)\n - `next_pagination`: Pagination info (has more pages, next page number, total pages, total records)\n - `timed_lists`: List of product statistics within each time range, including:\n - `product`:\n - `id`: Product ID\n - `name`: Product title\n - `cover_image.thumb_url_list`: List of product thumbnail URLs\n - `item_sold_cnt`: Number of items sold\n - `revenue.amount`: Total Gross Merchandise Value (GMV) generated by the product\n - `commission.amount`: Estimated commission income from the product\n\n### Notes:\n- This API is only available for TikTok Shop creator accounts.\n- Data is aggregated by natural month or the customized date range.\n- Default sorting is by GMV in descending order.\n\n### Parameters:\n- cookie: User Cookie string for authentication\n- start_date: Start date, formatted as 'YYYY-MM-DD', e.g., '2025-04-01'\n- end_date: End date, formatted as 'YYYY-MM-DD', e.g., '2025-05-01'\n- page: Page number, default is the first page `0`\n- proxy: Optional HTTP proxy address, can be omitted if not used\n - Example format: `http://username:password@host:port`\n\n### Return:\n- Creator product list and corresponding sales analytics data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_tiktok_creator_get_product_analytics_list", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Response Fields\n- `segments` (List of segmented data):\n - `filter.creator_id`: Creator account ID\n - `list_control`:\n - `rules`: Sorting rules (e.g., by revenue, by product ID)\n - `next_pagination`: Pagination info (has more pages, next page number, total pages, total records)\n - `timed_lists`: List of product statistics within each time range, including:\n - `product`:\n - `id`: Product ID\n - `name`: Product title\n - `cover_image.thumb_url_list`: List of product thumbnail URLs\n - `item_sold_cnt`: Number of items sold\n - `revenue.amount`: Total Gross Merchandise Value (GMV) generated by the product\n - `commission.amount`: Estimated commission income from the product\n\n### Return\n- Creator product list and corresponding sales analytics data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok get_product_analytics_list", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "fc18e4155458" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/creator/get_product_analytics_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_tiktok_creator_get_product_analytics_list", "method": "POST", "path": "/apis/v1/tikhub/tiktok/creator/get_product_analytics_list" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User Cookie String", "default": "Your_Cookie_String" }, "proxy": { "title": "Proxy", "description": "Optional HTTP proxy address, can be omitted if not used\n - Example format: `http://username:password@host:port`", "default": "", "type": [ "string", "null" ] }, "start_date": { "type": "string", "title": "Start Date", "description": "Start date, e.g. '2025-04-01'", "default": "2025-04-01" }, "end_date": { "type": "string", "title": "End Date", "description": "End Date, e.g. '2025-05-01'", "default": "2025-05-01" }, "page": { "type": "integer", "title": "Page", "description": "Page number, default is the first page `0`", "default": 0 } }, "type": "object", "title": "GetProductListRequest" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:10644a50aaca12ff309648238ea257de88e8b460e91256cf48ec884bd6c2b75b" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-tiktok-creator-get_product_analytics_list" } }, "/apis/v1/tikhub/tiktok/creator/get_product_related_videos": { "post": { "description": "TikTok (creator).\n\n### Purpose\n- Retrieve the list of all videos associated with a specified product along with their interaction metrics (such as like count, comment count, share count).\n- Useful for analyzing the promotional effectiveness and differences of the same product across different creators' videos.\n- Supports time-based filtering, defaulting to the calendar month of the specified start_date.\n\n### Notes\n- Requires both item_id (current video ID) and product_id (product ID).\n- Returns a list of other videos where the same product is featured.\n\n### Return Description\n- `segments`:\n - `time_selector`: Time filtering parameters (period, granularity, start_timestamp, end_timestamp)\n - `filter`: Query conditions (creator_id, product_id, item_id)\n - `timed_lists`: List of related videos\n - `start_timestamp`: Start timestamp\n - `end_timestamp`: End timestamp\n - `stats`:\n - `video_product_id`: Product ID\n - `video`:\n - `item_id`: Video ID\n - `video_id`: Video internal ID\n - `name`: Video caption/title\n - `publish_time`: Publish timestamp\n - `duration`: Video duration (seconds)\n - `video_play_info`:\n - `post_url`: Video cover image link\n - `video_infos.main_url`: Main video URL\n - `video_like_cnt`: Like count\n - `video_comment_cnt`: Comment count\n - `video_share_cnt`: Share count\n\n### Example Request Body\n```json\n{\n \"cookie\": \"your_cookie\",\n \"start_date\": \"04-01-2025\",\n \"item_id\": \"7496499484705246507\",\n \"product_id\": \"1731050202505515549\"\n}\n```\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_tiktok_creator_get_product_related_videos", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return Description\n- `segments`:\n - `time_selector`: Time filtering parameters (period, granularity, start_timestamp, end_timestamp)\n - `filter`: Query conditions (creator_id, product_id, item_id)\n - `timed_lists`: List of related videos\n - `start_timestamp`: Start timestamp\n - `end_timestamp`: End timestamp\n - `stats`:\n - `video_product_id`: Product ID\n - `video`:\n - `item_id`: Video ID\n - `video_id`: Video internal ID\n - `name`: Video caption/title\n - `publish_time`: Publish timestamp\n - `duration`: Video duration (seconds)\n - `video_play_info`:\n - `post_url`: Video cover image link\n - `video_infos.main_url`: Main video URL\n - `video_like_cnt`: Like count\n - `video_comment_cnt`: Comment count\n - `video_share_cnt`: Share count", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok get_product_related_videos", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "726c151d9ae1" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/creator/get_product_related_videos", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_tiktok_creator_get_product_related_videos", "method": "POST", "path": "/apis/v1/tikhub/tiktok/creator/get_product_related_videos" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User Cookie String", "default": "Your_Cookie_String" }, "proxy": { "title": "Proxy", "description": "Optional HTTP proxy address, can be omitted if not used\n - Example format: `http://username:password@host:port`", "default": "", "type": [ "string", "null" ] }, "start_date": { "type": "string", "title": "Start Date", "description": "Query Start Date, e.g. '04-01-2025'", "default": "04-01-2025" }, "item_id": { "type": "string", "title": "Item Id", "description": "Current video ID, for example \"7496499484705246507\"." }, "product_id": { "type": "string", "title": "Product Id", "description": "Product ID, for example \"1731050202505515549\"." } }, "type": "object", "required": [ "item_id", "product_id" ], "title": "GetProductRelatedVideosRequest" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:2a45c6bad8920fa8d48193ce4ad9438eb84c78b5ae7181c2cfab7f271dfb69e9" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-tiktok-creator-get_product_related_videos" } }, "/apis/v1/tikhub/tiktok/creator/get_showcase_product_list": { "post": { "description": "TikTok (creator).\n\n### Purpose\n- Retrieve the list of products currently displayed in a TikTok Shop creator's showcase.\n- Useful for product management, analytics, and monitoring promoted items.\n\n### Notes\n- Only available for TikTok creator accounts with the showcase feature enabled.\n- Supports pagination via `count` and `offset`.\n\n### Parameters\n- cookie: User Cookie string for authentication\n- count: Number of products per page (default 20)\n- offset: Pagination offset (default 0)\n- proxy: Optional HTTP proxy address\n - Example: `http://username:password@host:port`\n\n### Return Structure\n- `products` (List[Dict]): List of showcased products, including:\n - `product_id`, `title`, `format_available_price`, `seller_info`, `cover`, `images`, `source`, `stock_status`, `review_status`, `affiliate_info`, `category_info`.\n\n### Example Request\n```json\n{\n \"cookie\": \"your_cookie_string\",\n \"count\": 20,\n \"offset\": 0\n}\n```\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_tiktok_creator_get_showcase_product_list", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return Structure\n- `products` (List[Dict]): List of showcased products, including:\n - `product_id`, `title`, `format_available_price`, `seller_info`, `cover`, `images`, `source`, `stock_status`, `review_status`, `affiliate_info`, `category_info`.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok get_showcase_product_list", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "8973e07267ff" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/creator/get_showcase_product_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_tiktok_creator_get_showcase_product_list", "method": "POST", "path": "/apis/v1/tikhub/tiktok/creator/get_showcase_product_list" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User Cookie String", "default": "Your_Cookie_String" }, "proxy": { "title": "Proxy", "description": "Optional HTTP proxy address\n - Example: `http://username:password@host:port`", "default": "", "type": [ "string", "null" ] }, "count": { "type": "integer", "title": "Count", "description": "Page Size\n\nUsage: Number of products per page (default 20)", "default": 20 }, "offset": { "type": "integer", "title": "Offset", "description": "Pagination offset (default 0)", "default": 0 } }, "type": "object", "title": "GetShowcaseProductListRequest" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:b687f6fcf252faf59d145983a9c576482819e35e25febdac66373d3efaf96db5" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-tiktok-creator-get_showcase_product_list" } }, "/apis/v1/tikhub/tiktok/creator/get_video_analytics_summary": { "post": { "description": "TikTok (creator).\n\n### Purpose:\n- Retrieve a video performance overview for a TikTok Shop creator account over a specified time range.\n- By default, the API fetches data for the past 30 days (or full calendar month based on the platform settings).\n- Useful for analyzing metrics like video count, views, new followers, and generated GMV.\n\n### Response Fields:\n- `segments` (List of segmented data):\n - `time_selector`: Time period settings (period, start/end timestamps, timezone, locale)\n - `filter.creator_id`: Creator account ID\n - `timed_stats`: Video performance statistics for each time segment, including:\n - `vv_cnt`: Video Views Count\n - `new_follower_cnt`: Number of new followers\n - `video_cnt`: Number of videos published\n - `gmv.amount`: Gross Merchandise Value generated by videos\n - `items_sold`: Number of items sold\n\n### Notes:\n- This API is only available for TikTok Shop creator accounts.\n- If no data is available for a time segment, the `stats` field might be an empty `{}`.\n\n### Parameters:\n- cookie: User Cookie string for authentication\n- proxy: Optional HTTP proxy address, can be omitted if not used\n - Example format: `http://username:password@host:port`\n\n### Return:\n- Creator account video performance overview\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_tiktok_creator_get_video_analytics_summary", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Response Fields\n- `segments` (List of segmented data):\n - `time_selector`: Time period settings (period, start/end timestamps, timezone, locale)\n - `filter.creator_id`: Creator account ID\n - `timed_stats`: Video performance statistics for each time segment, including:\n - `vv_cnt`: Video Views Count\n - `new_follower_cnt`: Number of new followers\n - `video_cnt`: Number of videos published\n - `gmv.amount`: Gross Merchandise Value generated by videos\n - `items_sold`: Number of items sold\n\n### Return\n- Creator account video performance overview", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok get_video_analytics_summary", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "cf901dae5e9b" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/creator/get_video_analytics_summary", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_tiktok_creator_get_video_analytics_summary", "method": "POST", "path": "/apis/v1/tikhub/tiktok/creator/get_video_analytics_summary" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User Cookie String", "default": "Your_Cookie_String" }, "proxy": { "title": "Proxy", "description": "Optional HTTP proxy address, can be omitted if not used\n - Example format: `http://username:password@host:port`", "default": "", "type": [ "string", "null" ] } }, "type": "object", "title": "GetVideoOverviewRequest" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:1a696b396f2028cb56e1b8177e7a5a431584b9b58fb360b54ed44152dc4ea08b" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-tiktok-creator-get_video_analytics_summary" } }, "/apis/v1/tikhub/tiktok/creator/get_video_associated_product_list": { "post": { "description": "TikTok (creator).\n\n### Purpose\n- Retrieve the list of products associated with specified videos on TikTok Shop, along with their promotional performance data.\n- Useful for analyzing the number of products linked to each video, the product price range, product detail page links, and sales performance metrics.\n\n### Notes\n- Requires item_ids (list of video IDs).\n- The time range defaults to the calendar month of the specified start_date.\n- Supports querying multiple videos at once.\n\n### Return Description\n- `segments`:\n - `time_selector`: Time filter information (start/end timestamps)\n - `filter`: Query conditions (video ID list)\n - `timed_lists`: Product list associated with videos in the selected time range\n - `videoToProductsMap`:\n - `item_id`: Video ID\n - `products`:\n - `id`: Product ID\n - `name`: Product name\n - `cover_image.thumb_url_list`: List of product image URLs\n - `product_detail_page_url`: Product detail page link\n - `price_min` / `price_max`: Price range\n - `stats`:\n - `product.id`: Product ID\n - Promotional performance metrics (e.g., sales volume, CTR)\n\n### Example Request Body\n```json\n{\n \"cookie\": \"your_cookie\",\n \"start_date\": \"04-01-2025\",\n \"item_ids\": [\"7496499484705246507\", \"7496110433699482923\"]\n}\n```\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_tiktok_creator_get_video_associated_product_list", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return Description\n- `segments`:\n - `time_selector`: Time filter information (start/end timestamps)\n - `filter`: Query conditions (video ID list)\n - `timed_lists`: Product list associated with videos in the selected time range\n - `videoToProductsMap`:\n - `item_id`: Video ID\n - `products`:\n - `id`: Product ID\n - `name`: Product name\n - `cover_image.thumb_url_list`: List of product image URLs\n - `product_detail_page_url`: Product detail page link\n - `price_min` / `price_max`: Price range\n - `stats`:\n - `product.id`: Product ID\n - Promotional performance metrics (e.g., sales volume, CTR)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok get_video_associated_product_list", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "764ce7ce041b" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/creator/get_video_associated_product_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_tiktok_creator_get_video_associated_product_list", "method": "POST", "path": "/apis/v1/tikhub/tiktok/creator/get_video_associated_product_list" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User Cookie String", "default": "Your_Cookie_String" }, "proxy": { "title": "Proxy", "description": "Optional HTTP proxy address, can be omitted if not used\n - Example format: `http://username:password@host:port`", "default": "", "type": [ "string", "null" ] }, "start_date": { "type": "string", "title": "Start Date", "description": "Query Start Date, e.g. '04-01-2025'", "default": "04-01-2025" }, "item_ids": { "items": { "type": "string" }, "type": "array", "title": "Item Ids", "description": "Video ID list, for example [\"7496499484705246507\", \"7496110433699482923\"]." } }, "type": "object", "required": [ "item_ids" ], "title": "GetVideoAssociatedProductListRequest" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:7d4404cd993cc3c7ffac5fcf86eb57ea4e2d11ea69a5b0d6e3e24c246333e5d7" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-tiktok-creator-get_video_associated_product_list" } }, "/apis/v1/tikhub/tiktok/creator/get_video_audience_stats": { "post": { "description": "TikTok (creator).\n\n### Purpose\n- Retrieve audience profile statistics for a specified TikTok video, including gender distribution, age distribution, and regional distribution.\n- Useful for accurately understanding the characteristics of the video audience to guide content creation, product selection, and marketing strategy optimization.\n- Supports trend analysis across different time intervals (daily/weekly/monthly).\n\n### Notes\n- Requires item_id (video ID).\n- Audience profile data is based on characteristics of users who viewed and interacted with the video.\n\n### Return Description\n- `segments`:\n - `time_selector`: Time filtering parameters (period, granularity, start_timestamp, end_timestamp)\n - `filter`: Query conditions (creator_id, item_id)\n - `timed_profile`: Audience profile statistics\n - `start_timestamp`: Start timestamp\n - `end_timestamp`: End timestamp\n - `stats`:\n - `follower_genders`: Gender distribution\n - `key`: Gender (\"female\" or \"male\")\n - `value`: Proportion (string, range 0-1)\n - `follower_ages`: Age group distribution\n - `key`: Age group (e.g., \"18-24\", \"25-34\")\n - `value`: Proportion (string, range 0-1)\n - `follower_regions`: Regional distribution\n - `key`: Country code (e.g., \"US\")\n - `value`: Proportion (string, range 0-1)\n - `profile_type`: Profile type, fixed value 2 (Audience Profile)\n\n### Example Request Body\n```json\n{\n \"cookie\": \"your_cookie\",\n \"start_date\": \"04-01-2025\",\n \"item_id\": \"7496499484705246507\"\n}\n```\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_tiktok_creator_get_video_audience_stats", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return Description\n- `segments`:\n - `time_selector`: Time filtering parameters (period, granularity, start_timestamp, end_timestamp)\n - `filter`: Query conditions (creator_id, item_id)\n - `timed_profile`: Audience profile statistics\n - `start_timestamp`: Start timestamp\n - `end_timestamp`: End timestamp\n - `stats`:\n - `follower_genders`: Gender distribution\n - `key`: Gender (\"female\" or \"male\")\n - `value`: Proportion (string, range 0-1)\n - `follower_ages`: Age group distribution\n - `key`: Age group (e.g., \"18-24\", \"25-34\")\n - `value`: Proportion (string, range 0-1)\n - `follower_regions`: Regional distribution\n - `key`: Country code (e.g., \"US\")\n - `value`: Proportion (string, range 0-1)\n - `profile_type`: Profile type, fixed value 2 (Audience Profile)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok get_video_audience_stats", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "89b593cab63c" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/creator/get_video_audience_stats", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_tiktok_creator_get_video_audience_stats", "method": "POST", "path": "/apis/v1/tikhub/tiktok/creator/get_video_audience_stats" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User Cookie String", "default": "Your_Cookie_String" }, "proxy": { "title": "Proxy", "description": "Optional HTTP proxy address, can be omitted if not used\n - Example format: `http://username:password@host:port`", "default": "", "type": [ "string", "null" ] }, "start_date": { "type": "string", "title": "Start Date", "description": "Query Start Date, e.g. '04-01-2025'", "default": "04-01-2025" }, "item_id": { "type": "string", "title": "Item Id", "description": "Video ID, for example \"7496499484705246507\"." } }, "type": "object", "required": [ "item_id" ], "title": "GetVideoAudienceStatsRequest" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:f444f0e8f751dfe95a5e534b0ea08f7158609d31b9f6e392fb51e14cb33e1f25" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-tiktok-creator-get_video_audience_stats" } }, "/apis/v1/tikhub/tiktok/creator/get_video_detailed_stats": { "post": { "description": "TikTok (creator).\n\n### Purpose\n- Retrieve detailed segmented statistics for a specified TikTok video within a given calendar month.\n- Supports analyzing new followers, likes, comments, shares, product views, and video completion rates across different time segments (daily/weekly/monthly).\n- Useful for deeply analyzing the performance changes of a single video over time, optimizing content strategies and promotional outcomes.\n\n### Notes\n- Requires item_id (video ID).\n- Time range is based on the calendar month of start_date.\n- Large datasets will be automatically segmented based on granularity (daily/weekly/monthly).\n\n### Return Description\n- `segments`:\n - `time_selector`: Time filtering parameters (period, granularity, start_timestamp, end_timestamp)\n - `filter`: Query conditions (creator_id, item_id)\n - `timed_stats`: Segmented statistics list\n - `start_timestamp`: Start timestamp\n - `end_timestamp`: End timestamp\n - `stats`:\n - `creator_id`: Creator ID\n - `item_id`: Video ID\n - `new_follower_cnt`: Number of new followers\n - `share_cnt`: Number of shares\n - `comment_cnt`: Number of comments\n - `like_cnt`: Number of likes\n - `product_view_cnt`: Number of product views\n - `video_completion_rate`: Video completion rate (string, range 0-1)\n\n### Example Request Body\n```json\n{\n \"cookie\": \"your_cookie\",\n \"start_date\": \"04-01-2025\",\n \"item_id\": \"7496499484705246507\"\n}\n```\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_tiktok_creator_get_video_detailed_stats", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return Description\n- `segments`:\n - `time_selector`: Time filtering parameters (period, granularity, start_timestamp, end_timestamp)\n - `filter`: Query conditions (creator_id, item_id)\n - `timed_stats`: Segmented statistics list\n - `start_timestamp`: Start timestamp\n - `end_timestamp`: End timestamp\n - `stats`:\n - `creator_id`: Creator ID\n - `item_id`: Video ID\n - `new_follower_cnt`: Number of new followers\n - `share_cnt`: Number of shares\n - `comment_cnt`: Number of comments\n - `like_cnt`: Number of likes\n - `product_view_cnt`: Number of product views\n - `video_completion_rate`: Video completion rate (string, range 0-1)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok get_video_detailed_stats", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "42c6d858def4" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/creator/get_video_detailed_stats", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_tiktok_creator_get_video_detailed_stats", "method": "POST", "path": "/apis/v1/tikhub/tiktok/creator/get_video_detailed_stats" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User Cookie String", "default": "Your_Cookie_String" }, "proxy": { "title": "Proxy", "description": "Optional HTTP proxy address, can be omitted if not used\n - Example format: `http://username:password@host:port`", "default": "", "type": [ "string", "null" ] }, "start_date": { "type": "string", "title": "Start Date", "description": "Query Start Date, e.g. '04-01-2025'", "default": "04-01-2025" }, "item_id": { "type": "string", "title": "Item Id", "description": "Video ID, for example \"7496499484705246507\"." } }, "type": "object", "required": [ "item_id" ], "title": "GetVideoDetailedStatsRequest" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:0941452fe31d7b24501d6d5679294c486e46f3f9c403c7e956abce6800390bf2" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-tiktok-creator-get_video_detailed_stats" } }, "/apis/v1/tikhub/tiktok/creator/get_video_list_analytics": { "post": { "description": "TikTok (creator).\n\n### Purpose:\n- Retrieve a list of videos published by a TikTok Shop creator account within a specified time range, along with detailed performance metrics.\n- Supports pagination to fetch multiple pages of video records within the given time range.\n\n### Response Fields:\n- `segments` (List of segmented data):\n - `time_selector`: Time range settings (start/end timestamps, timezone, locale)\n - `filter.creator_id`: Creator account ID\n - `list_control`:\n - `rules`: List sorting rules (typically by publish time descending)\n - `next_pagination`: Pagination information (has more pages, current page, total pages, total records)\n - `timed_lists`: List of videos for each time range, including:\n - `video_meta`:\n - `item_id`: Video Item ID\n - `name`: Video title\n - `publish_time`: Video publish time (Unix timestamp)\n - `duration`: Video duration (seconds)\n - `video_play_info`: Video play resources (cover image, playback URL, etc.)\n - `new_follower_cnt`: Number of new followers during the video's period\n - `vv_cnt`: Video views count\n - `ctr`: Click Through Rate for associated products\n - `gmv.amount`: Gross Merchandise Value generated by the video\n - `item_sold_cnt`: Number of items sold due to the video\n - `direct_gmv.amount`: Direct GMV from the video\n - `completion_rate`: Video completion rate\n\n### Notes:\n- This API is only available for TikTok Shop creator accounts.\n- Data is grouped by natural day or week, and each video's stats represent the corresponding period.\n\n### Parameters:\n- cookie: User Cookie string for authentication\n- start_date: Query start date, formatted as 'MM-DD-YYYY', e.g., '04-01-2025'\n- page: Page number, default is the first page `0`\n- rules: List sorting rules, default is by publish time. Available options:\n - `\"VIDEO_LIST_PUBLISH_TIME\"`: Sort by video publish time\n - `\"VIDEO_LIST_GMV\"`: Sort by gross merchandise value (GMV)\n - `\"VIDEO_LIST_DIRECT_GMV\"`: Sort by direct GMV\n - `\"VIDEO_LIST_VV_CNT\"`: Sort by video view count\n - `\"VIDEO_LIST_ITEM_SOLD_CNT\"`: Sort by number of items sold\n - `\"VIDEO_LIST_CTR\"`: Sort by click-through rate\n - `\"VIDEO_LIST_COMPLETION_RATE\"`: Sort by video completion rate\n - `\"VIDEO_LIST_LIKE_CNT\"`: Sort by number of likes\n - `\"VIDEO_LIST_NEW_FOLLOWER_CNT\"`: Sort by number of new followers\n- proxy: Optional HTTP proxy address, can be omitted if not used\n - Example format: `http://username:password@host:port`\n\n### Return:\n- Detailed video list and performance analysis for the creator account\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_tiktok_creator_get_video_list_analytics", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Response Fields\n- `segments` (List of segmented data):\n - `time_selector`: Time range settings (start/end timestamps, timezone, locale)\n - `filter.creator_id`: Creator account ID\n - `list_control`:\n - `rules`: List sorting rules (typically by publish time descending)\n - `next_pagination`: Pagination information (has more pages, current page, total pages, total records)\n - `timed_lists`: List of videos for each time range, including:\n - `video_meta`:\n - `item_id`: Video Item ID\n - `name`: Video title\n - `publish_time`: Video publish time (Unix timestamp)\n - `duration`: Video duration (seconds)\n - `video_play_info`: Video play resources (cover image, playback URL, etc.)\n - `new_follower_cnt`: Number of new followers during the video's period\n - `vv_cnt`: Video views count\n - `ctr`: Click Through Rate for associated products\n - `gmv.amount`: Gross Merchandise Value generated by the video\n - `item_sold_cnt`: Number of items sold due to the video\n - `direct_gmv.amount`: Direct GMV from the video\n - `completion_rate`: Video completion rate\n\n### Return\n- Detailed video list and performance analysis for the creator account", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok get_video_list_analytics", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "cb6efd0b3a21" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/creator/get_video_list_analytics", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_tiktok_creator_get_video_list_analytics", "method": "POST", "path": "/apis/v1/tikhub/tiktok/creator/get_video_list_analytics" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User Cookie String", "default": "Your_Cookie_String" }, "proxy": { "title": "Proxy", "description": "Optional HTTP proxy address, can be omitted if not used\n - Example format: `http://username:password@host:port`", "default": "", "type": [ "string", "null" ] }, "start_date": { "type": "string", "title": "Start Date", "description": "Query Start Date, e.g. '04-01-2025'", "default": "04-01-2025" }, "page": { "type": "integer", "title": "Page", "description": "Page number, default is the first page `0`", "default": 0 }, "rules": { "type": "string", "title": "Rules", "description": "List sorting rules, default is by publish time. Available options:\n - `\"VIDEO_LIST_PUBLISH_TIME\"`: Sort by video publish time\n - `\"VIDEO_LIST_GMV\"`: Sort by gross merchandise value (GMV)\n - `\"VIDEO_LIST_DIRECT_GMV\"`: Sort by direct GMV\n - `\"VIDEO_LIST_VV_CNT\"`: Sort by video view count\n - `\"VIDEO_LIST_ITEM_SOLD_CNT\"`: Sort by number of items sold\n - `\"VIDEO_LIST_CTR\"`: Sort by click-through rate\n - `\"VIDEO_LIST_COMPLETION_RATE\"`: Sort by video completion rate\n - `\"VIDEO_LIST_LIKE_CNT\"`: Sort by number of likes\n - `\"VIDEO_LIST_NEW_FOLLOWER_CNT\"`: Sort by number of new followers", "default": "VIDEO_LIST_PUBLISH_TIME" } }, "type": "object", "title": "GetVideoListRequest" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:1fd92e85829b1db78f2a2bd2661200ceac82b0c03d677102052ad4b8c3583d58" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-tiktok-creator-get_video_list_analytics" } }, "/apis/v1/tikhub/tiktok/creator/get_video_to_product_stats": { "post": { "description": "TikTok (creator).\n\n### Purpose\n- Retrieve detailed promotional statistics between a specific TikTok video and a specific product.\n- Supports analyzing metrics such as product views, clicks, sales, order counts, product revenue, and direct revenue.\n- The data is segmented by time intervals (daily/weekly/monthly) to observe trends over time.\n\n### Notes\n- Requires both item_id (video ID) and product_id (product ID).\n- The time range is based on the calendar month of the specified start_date.\n\n### Return Description\n- `segments`:\n - `time_selector`: Time filtering parameters (period, granularity, start_timestamp, end_timestamp)\n - `filter`: Query conditions (creator_id, item_id, product_id)\n - `timed_stats`: Segmented statistics list\n - `start_timestamp`: Start timestamp\n - `end_timestamp`: End timestamp\n - `stats`:\n - `item_id`: Video ID\n - `product_id`: Product ID\n - `product_revenue.amount_formatted`: Total product revenue (formatted string, e.g., \"$100.00\")\n - `product_revenue.amount`: Total product revenue (numeric)\n - `direct_revenue.amount_formatted`: Direct sales revenue (formatted string)\n - `product_sales_cnt`: Number of products sold\n - `product_view_cnt`: Number of product views\n - `product_click_cnt`: Number of product clicks\n - `order_cnt`: Number of orders created\n\n### Example Request Body\n```json\n{\n \"cookie\": \"your_cookie\",\n \"start_date\": \"04-01-2025\",\n \"item_id\": \"7496499484705246507\",\n \"product_id\": \"1731050202505515549\"\n}\n```\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_tiktok_creator_get_video_to_product_stats", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return Description\n- `segments`:\n - `time_selector`: Time filtering parameters (period, granularity, start_timestamp, end_timestamp)\n - `filter`: Query conditions (creator_id, item_id, product_id)\n - `timed_stats`: Segmented statistics list\n - `start_timestamp`: Start timestamp\n - `end_timestamp`: End timestamp\n - `stats`:\n - `item_id`: Video ID\n - `product_id`: Product ID\n - `product_revenue.amount_formatted`: Total product revenue (formatted string, e.g., \"$100.00\")\n - `product_revenue.amount`: Total product revenue (numeric)\n - `direct_revenue.amount_formatted`: Direct sales revenue (formatted string)\n - `product_sales_cnt`: Number of products sold\n - `product_view_cnt`: Number of product views\n - `product_click_cnt`: Number of product clicks\n - `order_cnt`: Number of orders created", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok get_video_to_product_stats", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "7fac93710c99" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/creator/get_video_to_product_stats", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_tiktok_creator_get_video_to_product_stats", "method": "POST", "path": "/apis/v1/tikhub/tiktok/creator/get_video_to_product_stats" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "cookie": { "type": "string", "title": "Cookie", "description": "User Cookie String", "default": "Your_Cookie_String" }, "proxy": { "title": "Proxy", "description": "Optional HTTP proxy address, can be omitted if not used\n - Example format: `http://username:password@host:port`", "default": "", "type": [ "string", "null" ] }, "start_date": { "type": "string", "title": "Start Date", "description": "Query Start Date, e.g. '04-01-2025'", "default": "04-01-2025" }, "item_id": { "type": "string", "title": "Item Id", "description": "Video ID, for example \"7496499484705246507\"." }, "product_id": { "type": "string", "title": "Product Id", "description": "Product ID, for example \"1731050202505515549\"." } }, "type": "object", "required": [ "item_id", "product_id" ], "title": "GetVideoToProductStatsRequest" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:876f13e1ad315f0545631a92935d6ca4dc5b303fbb2d2298eeec891b30408db6" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-tiktok-creator-get_video_to_product_stats" } }, "/apis/v1/tikhub/tiktok/shop/web/fetch_hot_selling_products_list": { "get": { "description": "TikTok (shop/web).\n\n### ⚠️ This API is deprecated:\n- To fetch products by category or keyword, use `fetch_products_by_category_id` or `fetch_search_products_list`\n### Purpose:\n- Get TikTok Shop hot selling products list\n- Returns currently most popular products\n### Parameters:\n- region: Region code (US/SG/MY/PH/TH/VN/ID/JP/MX)\n- count: Number of products to return, default 20 (optional). Larger values are slower\n- exclude_product_ids: Comma-separated product IDs you already have (optional), used for paging\n### Pagination:\n- This endpoint has no page or offset parameter\n- To fetch the next batch, pass the product IDs you already have as a comma-separated\n list in `exclude_product_ids`; the endpoint skips them and returns new products\n- `data.hasMore` is `true` when more products are available, `false` when exhausted\n### Response Structure:\n```json\n{\n \"code\": 0,\n \"message\": \"success\",\n \"data\": {\n \"hasMore\": true, // Whether more products are available\n \"productList\": [ // Hot selling products\n {\n \"product_id\": \"1731128793906516409\",\n \"title\": \"Product title\"\n // Remaining fields are passed through as returned upstream\n }\n ]\n }\n}\n```\n\nAPI references: `fetch_products_by_category_id` = `GET /tikhub/tiktok/shop/web/fetch_products_by_category_id` (operationId: `get_tikhub_tiktok_shop_web_fetch_products_by_category_id`).\n\nUpstream-only reference: `fetch_search_products_list` is `GET /api/v1/tiktok/shop/web/fetch_search_products_list` in the official API. It is not exposed as an operation in this specification.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_shop_web_fetch_hot_selling_products_list", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Response Structure\n```json\n{\n \"code\": 0,\n \"message\": \"success\",\n \"data\": {\n \"hasMore\": true, // Whether more products are available\n \"productList\": [ // Hot selling products\n {\n \"product_id\": \"1731128793906516409\",\n \"title\": \"Product title\"\n // Remaining fields are passed through as returned upstream\n }\n ]\n }\n}\n```", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok web/fetch_hot_selling_products_list", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "2a5567418dd5" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/shop/web/fetch_hot_selling_products_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_shop_web_fetch_hot_selling_products_list", "method": "GET", "path": "/apis/v1/tikhub/tiktok/shop/web/fetch_hot_selling_products_list" }, "parameters": [ { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number of products to return, default 20 (optional). Larger values are slower", "default": 20, "title": "Count" }, "description": "Number of products to return, default 20 (optional). Larger values are slower", "example": 20 }, { "name": "exclude_product_ids", "in": "query", "required": false, "schema": { "type": "string", "description": "Comma-separated product IDs you already have, used for paging", "default": "", "title": "Exclude Product Ids" }, "description": "Comma-separated product IDs you already have, used for paging", "example": "1731128793906516409,1732305963897557680" }, { "name": "region", "in": "query", "required": false, "schema": { "type": "string", "description": "Region code: US, SG, MY, PH, TH, VN, ID, JP, or MX. GB and BR are unavailable. Unsupported regions return HTTP 200 with data.region_supported=false and supported_regions.", "default": "US", "title": "Region" }, "description": "Region code: US, SG, MY, PH, TH, VN, ID, JP, or MX. GB and BR are unavailable. Unsupported regions return HTTP 200 with data.region_supported=false and supported_regions.", "example": "US" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:c9f04074e17a517aea274eaf8fadffc2a8b2fbc828d33e051aba3121292accf9" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-shop-web-fetch_hot_selling_products_list" } }, "/apis/v1/tikhub/tiktok/shop/web/fetch_product_detail_v3": { "get": { "description": "TikTok (shop/web).\n\n### Purpose:\n- Get TikTok Shop product details\n- Provides the most complete product information including recommendations, videos, shop info, etc.\n- Suitable for products from supported regions; GB and BR are unavailable\n### Parameters:\n- product_id: Product ID (required)\n- region: Region code (US/SG/MY/PH/TH/VN/ID/JP/MX)\n### Important Notice:\n- **Please ensure that the `region` matches the actual region of the `product_id`, otherwise the API will not return any data.**\n- Due to API rate limiting, please set request timeout to 30 seconds\n- If you encounter error code 400, please retry the request 3 times\n### Response Structure:\n```json\n{\n \"code\": 200,\n \"data\": {\n \"productInfo\": {}, // Product details\n \"frequentlyBoughtTogether\": [], // Frequently bought together\n \"similarProductsInCategory\": [], // Similar products in category\n \"exploreMoreFromShop\": [], // More from shop\n \"brandInCategoryRecommendedProducts\": [], // Brand category recommendations\n \"customersAlsoBought\": [], // Customers also bought\n \"moreInThisColorStyle\": [], // More colors/styles\n \"relatedVideos\": [], // Related videos\n \"shopPerformance\": {}, // Shop performance\n \"categoryInfo\": {}, // Category info\n \"searchRecommendWords\": [], // Search recommendation words\n \"randomSearchWord\": \"\", // Random search word\n \"shopInfo\": {}, // Shop information\n \"shopHotReviews\": [] // Shop hot reviews\n }\n}\n```\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_shop_web_fetch_product_detail_v3", "responses": { "200": { "description": "Successful Response\n\n### Response Structure\n```json\n{\n \"code\": 200,\n \"data\": {\n \"productInfo\": {}, // Product details\n \"frequentlyBoughtTogether\": [], // Frequently bought together\n \"similarProductsInCategory\": [], // Similar products in category\n \"exploreMoreFromShop\": [], // More from shop\n \"brandInCategoryRecommendedProducts\": [], // Brand category recommendations\n \"customersAlsoBought\": [], // Customers also bought\n \"moreInThisColorStyle\": [], // More colors/styles\n \"relatedVideos\": [], // Related videos\n \"shopPerformance\": {}, // Shop performance\n \"categoryInfo\": {}, // Category info\n \"searchRecommendWords\": [], // Search recommendation words\n \"randomSearchWord\": \"\", // Random search word\n \"shopInfo\": {}, // Shop information\n \"shopHotReviews\": [] // Shop hot reviews\n }\n}\n```", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok web/fetch_product_detail", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "53bb96f2def2" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/shop/web/fetch_product_detail_v3", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_shop_web_fetch_product_detail_v3", "method": "GET", "path": "/apis/v1/tikhub/tiktok/shop/web/fetch_product_detail_v3" }, "parameters": [ { "name": "product_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Product ID", "title": "Product Id" }, "description": "Product ID", "example": "1732108663255959373" }, { "name": "region", "in": "query", "required": false, "schema": { "type": "string", "description": "Region code: US, SG, MY, PH, TH, VN, ID, JP, or MX. GB and BR are unavailable. Unsupported regions return HTTP 200 with data.region_supported=false and supported_regions.", "default": "SG", "title": "Region" }, "description": "Region code: US, SG, MY, PH, TH, VN, ID, JP, or MX. GB and BR are unavailable. Unsupported regions return HTTP 200 with data.region_supported=false and supported_regions.", "example": "SG" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:6dd88160d73c50f53d8c25af0009170df7aad07237b589d2d7d23ce0adcd729e" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/shop/web/fetch_product_detail_v3?product_id=1732108663255959373®ion=SG' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-shop-web-fetch_product_detail_v3" } }, "/apis/v1/tikhub/tiktok/shop/web/fetch_product_id_by_share_link": { "get": { "description": "TikTok (shop/web).\n\n### Purpose:\n- Get Product ID by Share Link\n### Parameters:\n- share_link: Share link\n### Return:\n- Product ID\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_shop_web_fetch_product_id_by_share_link", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Product ID", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok web/fetch_product_id_by_share_link", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "88e430c5f58f" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/shop/web/fetch_product_id_by_share_link", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_shop_web_fetch_product_id_by_share_link", "method": "GET", "path": "/apis/v1/tikhub/tiktok/shop/web/fetch_product_id_by_share_link" }, "parameters": [ { "name": "region", "in": "query", "required": false, "schema": { "type": "string", "description": "地区代码：US/SG/MY/PH/TH/VN/ID/JP/MX；GB 和 BR 暂不支持 / Region code: US/SG/MY/PH/TH/VN/ID/JP/MX; GB and BR are unavailable", "default": "US", "title": "Region" }, "description": "地区代码：US/SG/MY/PH/TH/VN/ID/JP/MX；GB 和 BR 暂不支持 / Region code: US/SG/MY/PH/TH/VN/ID/JP/MX; GB and BR are unavailable", "example": "US" }, { "name": "share_link", "in": "query", "required": true, "schema": { "type": "string", "description": "Share link", "title": "Share Link" }, "description": "Share link", "example": "https://affiliate-us.tiktok.com/api/v1/share/AJ4hS3OdXmSg" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:6fdbe7b3f41fd23d1d242c0d223951baff16072dfcab9fb56409232f63051931" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/shop/web/fetch_product_id_by_share_link?region=US&share_link=https%3A%2F%2Faffiliate-us.tiktok.com%2Fapi%2Fv1%2Fshare%2FAJ4hS3OdXmSg' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-shop-web-fetch_product_id_by_share_link" } }, "/apis/v1/tikhub/tiktok/shop/web/fetch_product_reviews_v2": { "get": { "description": "TikTok (shop/web).\n\n### Purpose:\n- Get TikTok Shop product reviews\n- Support multiple filtering and sorting options\n- More complete data structure with detailed review information\n### Parameters:\n- product_id: Product ID (required)\n- page_start: Starting page number, default 1\n - When has_more=1 in response, use current page +1 for next page\n- sort_rule: Sort order, default 2\n - 1: Recommended\n - 2: Most recent\n- filter_type: Review filter type, default 1\n - 1: All reviews; use filter_value to select all ratings or a specific rating\n - 2: Reviews containing images or videos; filter_value must be 1\n - 3: Verified-purchase reviews; filter_value must be 1\n- filter_value: Used together with filter_type\n - When filter_type=1: 6=all ratings (default), 5=5-star, 4=4-star, 3=3-star, 2=2-star, 1=1-star\n - When filter_type=2 or 3: use 1\n- region: Region code, available regions are as follows:\n - US: United States\n - SG: Singapore\n - MY: Malaysia\n - PH: Philippines\n - TH: Thailand\n - VN: Vietnam\n - ID: Indonesia\n - JP: Japan\n - MX: Mexico\n### Filter Combination Examples:\n- All reviews: filter_type=1, filter_value=6\n- 5-star reviews: filter_type=1, filter_value=5\n- Reviews with images or videos: filter_type=2, filter_value=1\n- Verified-purchase reviews: filter_type=3, filter_value=1\n### Important Notice:\n- Set the request timeout to 30 seconds\n- Only products accessible via TikTok Shop Web are supported\n### Response Structure:\n```json\n{\n \"code\": 0,\n \"message\": \"success\",\n \"data\": {\n \"reviews\": [ // Review list (20 per page)\n {\n \"review_id\": \"xxx\",\n \"user\": { // User info\n \"user_id\": \"xxx\",\n \"nickname\": \"Username\",\n \"avatar\": \"Avatar URL\"\n },\n \"rating\": 5, // Rating (1-5 stars)\n \"content\": \"Review content\",\n \"medias\": [ // Media files (images/videos)\n {\n \"type\": \"image\",\n \"url\": \"Media URL\"\n }\n ],\n \"create_time\": 0, // Create timestamp\n \"verified_purchase\": true, // Is verified purchase\n \"product_info\": {}, // Product info\n \"likes_count\": 10, // Likes count\n \"seller_reply\": {} // Seller reply\n }\n ],\n \"has_more\": 1, // Has more: 1=yes, 0=no\n \"page_start\": 1, // Current page\n \"total_count\": 500, // Total review count\n \"review_summary\": { // Review summary\n \"average_rating\": 4.8,\n \"star_distribution\": { // Star distribution\n \"5\": 400,\n \"4\": 80,\n \"3\": 15,\n \"2\": 3,\n \"1\": 2\n }\n }\n }\n}\n```\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_shop_web_fetch_product_reviews_v2", "responses": { "200": { "description": "Successful Response\n\n### Response Structure\n```json\n{\n \"code\": 0,\n \"message\": \"success\",\n \"data\": {\n \"reviews\": [ // Review list (20 per page)\n {\n \"review_id\": \"xxx\",\n \"user\": { // User info\n \"user_id\": \"xxx\",\n \"nickname\": \"Username\",\n \"avatar\": \"Avatar URL\"\n },\n \"rating\": 5, // Rating (1-5 stars)\n \"content\": \"Review content\",\n \"medias\": [ // Media files (images/videos)\n {\n \"type\": \"image\",\n \"url\": \"Media URL\"\n }\n ],\n \"create_time\": 0, // Create timestamp\n \"verified_purchase\": true, // Is verified purchase\n \"product_info\": {}, // Product info\n \"likes_count\": 10, // Likes count\n \"seller_reply\": {} // Seller reply\n }\n ],\n \"has_more\": 1, // Has more: 1=yes, 0=no\n \"page_start\": 1, // Current page\n \"total_count\": 500, // Total review count\n \"review_summary\": { // Review summary\n \"average_rating\": 4.8,\n \"star_distribution\": { // Star distribution\n \"5\": 400,\n \"4\": 80,\n \"3\": 15,\n \"2\": 3,\n \"1\": 2\n }\n }\n }\n}\n```", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok web/fetch_product_reviews", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "1a21f1926af0" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/shop/web/fetch_product_reviews_v2", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_shop_web_fetch_product_reviews_v2", "method": "GET", "path": "/apis/v1/tikhub/tiktok/shop/web/fetch_product_reviews_v2" }, "parameters": [ { "name": "filter_type", "in": "query", "required": false, "schema": { "type": "integer", "description": "Filter type: 1=All, 2=With images or videos, 3=Verified purchase\n\nUsage: Review filter type, default 1\n - 1: All reviews; use filter_value to select all ratings or a specific rating\n - 2: Reviews containing images or videos; filter_value must be 1\n - 3: Verified-purchase reviews; filter_value must be 1", "default": 1, "title": "Filter Type" }, "description": "Filter type: 1=All, 2=With images or videos, 3=Verified purchase\n\nUsage: Review filter type, default 1\n - 1: All reviews; use filter_value to select all ratings or a specific rating\n - 2: Reviews containing images or videos; filter_value must be 1\n - 3: Verified-purchase reviews; filter_value must be 1", "example": 1 }, { "name": "filter_value", "in": "query", "required": false, "schema": { "type": "integer", "description": "Filter value: For filter_type=1, 6=all and 5-1=star rating; use 1 for filter_type=2 or 3\n\nUsage: Used together with filter_type\n - When filter_type=1: 6=all ratings (default), 5=5-star, 4=4-star, 3=3-star, 2=2-star, 1=1-star\n - When filter_type=2 or 3: use 1", "default": 6, "title": "Filter Value" }, "description": "Filter value: For filter_type=1, 6=all and 5-1=star rating; use 1 for filter_type=2 or 3\n\nUsage: Used together with filter_type\n - When filter_type=1: 6=all ratings (default), 5=5-star, 4=4-star, 3=3-star, 2=2-star, 1=1-star\n - When filter_type=2 or 3: use 1", "example": 6 }, { "name": "page_start", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page start\n\nUsage: Starting page number, default 1\n - When has_more=1 in response, use current page +1 for next page", "default": 1, "title": "Page Start" }, "description": "Page start\n\nUsage: Starting page number, default 1\n - When has_more=1 in response, use current page +1 for next page", "example": 1 }, { "name": "product_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Product ID", "title": "Product Id" }, "description": "Product ID", "example": "1729408816995078528" }, { "name": "region", "in": "query", "required": false, "schema": { "type": "string", "description": "Region code: US, SG, MY, PH, TH, VN, ID, JP, or MX. GB and BR are unavailable. Unsupported regions return HTTP 200 with data.region_supported=false and supported_regions.", "default": "US", "title": "Region" }, "description": "Region code: US, SG, MY, PH, TH, VN, ID, JP, or MX. GB and BR are unavailable. Unsupported regions return HTTP 200 with data.region_supported=false and supported_regions.", "example": "US" }, { "name": "sort_rule", "in": "query", "required": false, "schema": { "type": "integer", "description": "Sort order: 1=Recommended, 2=Most recent\n\nUsage: Sort order, default 2\n - 1: Recommended\n - 2: Most recent", "default": 2, "title": "Sort Rule" }, "description": "Sort order: 1=Recommended, 2=Most recent\n\nUsage: Sort order, default 2\n - 1: Recommended\n - 2: Most recent", "example": 2 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:5a91cd5925539fbb33233829112737d8231f140a61e0646470082097f78ac5f9" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/shop/web/fetch_product_reviews_v2?filter_type=1&filter_value=6&page_start=1&product_id=1729408816995078528®ion=US&sort_rule=2' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-shop-web-fetch_product_reviews_v2" } }, "/apis/v1/tikhub/tiktok/shop/web/fetch_products_by_category_id": { "get": { "description": "TikTok (shop/web).\n\n### Purpose:\n- Get product list by category ID\n- Can be used to build category browsing feature\n### Parameters:\n- category_id: Category ID (required, from fetch_products_category_list API)\n- offset: Offset for pagination (default 0)\n - Default 20 products per page, increase by 20 for each request. If `hasMore` in response is true, can request next page, otherwise reached last page.\n - Example: Page 1 offset=0, Page 2 offset=20, Page 3 offset=40, and so on.\n- region: Region code (US/SG/MY/PH/TH/VN/ID/JP/MX)\n### Important Notice:\n- Due to API rate limiting, please set request timeout to 30 seconds\n- If you encounter error code 400, please retry the request 3 times\n### Response Structure:\n```json\n{\n \"code\": 0,\n \"message\": \"success\",\n \"data\": {\n \"products\": [ // Product list (up to 20)\n {\n \"product_id\": \"xxx\",\n \"title\": \"Product title\",\n \"image\": \"Product image\",\n \"price\": {}, // Price info\n \"rating\": {}, // Rating info\n \"sales\": {} // Sales info\n }\n ]\n }\n}\n```\n\nAPI references: `fetch_products_category_list` = `GET /tikhub/tiktok/shop/web/fetch_products_category_list` (operationId: `get_tikhub_tiktok_shop_web_fetch_products_category_list`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_shop_web_fetch_products_by_category_id", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Response Structure\n```json\n{\n \"code\": 0,\n \"message\": \"success\",\n \"data\": {\n \"products\": [ // Product list (up to 20)\n {\n \"product_id\": \"xxx\",\n \"title\": \"Product title\",\n \"image\": \"Product image\",\n \"price\": {}, // Price info\n \"rating\": {}, // Rating info\n \"sales\": {} // Sales info\n }\n ]\n }\n}\n```", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok web/fetch_products_by_category_id", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "38f626958cbe" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/shop/web/fetch_products_by_category_id", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_shop_web_fetch_products_by_category_id", "method": "GET", "path": "/apis/v1/tikhub/tiktok/shop/web/fetch_products_by_category_id" }, "parameters": [ { "name": "category_id", "in": "query", "required": true, "schema": { "type": "integer", "description": "Category ID (required, from fetch_products_category_list API)\n\nAPI references: `fetch_products_category_list` = `GET /tikhub/tiktok/shop/web/fetch_products_category_list` (operationId: `get_tikhub_tiktok_shop_web_fetch_products_category_list`).", "title": "Category Id" }, "description": "Category ID (required, from fetch_products_category_list API)\n\nAPI references: `fetch_products_category_list` = `GET /tikhub/tiktok/shop/web/fetch_products_category_list` (operationId: `get_tikhub_tiktok_shop_web_fetch_products_category_list`).", "example": 963976 }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "description": "Offset for pagination (default 0)\n - Default 20 products per page, increase by 20 for each request. If `hasMore` in response is true, can request next page, otherwise reached last page.\n - Example: Page 1 offset=0, Page 2 offset=20, Page 3 offset=40, and so on.", "default": 0, "title": "Offset" }, "description": "Offset for pagination (default 0)\n - Default 20 products per page, increase by 20 for each request. If `hasMore` in response is true, can request next page, otherwise reached last page.\n - Example: Page 1 offset=0, Page 2 offset=20, Page 3 offset=40, and so on.", "example": 0 }, { "name": "region", "in": "query", "required": false, "schema": { "type": "string", "description": "Region code: US, SG, MY, PH, TH, VN, ID, JP, or MX. GB and BR are unavailable. Unsupported regions return HTTP 200 with data.region_supported=false and supported_regions.", "default": "US", "title": "Region" }, "description": "Region code: US, SG, MY, PH, TH, VN, ID, JP, or MX. GB and BR are unavailable. Unsupported regions return HTTP 200 with data.region_supported=false and supported_regions.", "example": "US" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:fdbb5c99e8f9ff75713c83feaeb8c8b23658f84978df1ea8ad2f8a0f0c18050b" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/shop/web/fetch_products_by_category_id?category_id=963976&offset=0®ion=US' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-shop-web-fetch_products_by_category_id" } }, "/apis/v1/tikhub/tiktok/shop/web/fetch_products_category_list": { "get": { "description": "TikTok (shop/web).\n\n### Purpose:\n- Get TikTok Shop product category directory\n- Returns complete category tree structure\n### Parameters:\n- region: Region code (US/SG/MY/PH/TH/VN/ID/JP/MX)\n### Response Structure:\n```json\n[\n {\n \"self\": { // Category info\n \"category_id\": \"xxx\",\n \"category_level\": 1,\n \"is_leaf\": false,\n \"parent_category_id\": \"0\",\n \"category_name\": \"Category Name\",\n \"category_name_en\": \"Category Name\",\n \"image_url\": \"Category image URL\"\n },\n \"children\": [ // Sub-categories\n {\n \"self\": {...},\n \"children\": [...]\n }\n ]\n }\n]\n```\n- Total about 28 main categories\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_shop_web_fetch_products_category_list", "responses": { "200": { "description": "Successful Response\n\n### Response Structure\n```json\n[\n {\n \"self\": { // Category info\n \"category_id\": \"xxx\",\n \"category_level\": 1,\n \"is_leaf\": false,\n \"parent_category_id\": \"0\",\n \"category_name\": \"Category Name\",\n \"category_name_en\": \"Category Name\",\n \"image_url\": \"Category image URL\"\n },\n \"children\": [ // Sub-categories\n {\n \"self\": {...},\n \"children\": [...]\n }\n ]\n }\n]\n```\n- Total about 28 main categories", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok web/fetch_products_category_list", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "77b0f16c79a4" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/shop/web/fetch_products_category_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_shop_web_fetch_products_category_list", "method": "GET", "path": "/apis/v1/tikhub/tiktok/shop/web/fetch_products_category_list" }, "parameters": [ { "name": "region", "in": "query", "required": false, "schema": { "type": "string", "description": "Region code: US, SG, MY, PH, TH, VN, ID, JP, or MX. GB and BR are unavailable. Unsupported regions return HTTP 200 with data.region_supported=false and supported_regions.", "default": "US", "title": "Region" }, "description": "Region code: US, SG, MY, PH, TH, VN, ID, JP, or MX. GB and BR are unavailable. Unsupported regions return HTTP 200 with data.region_supported=false and supported_regions.", "example": "US" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:12f3c6bbf8c7d95f7a6064d2a8200558757c9a07803a0b1061a5106a1258e22b" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-shop-web-fetch_products_category_list" } }, "/apis/v1/tikhub/tiktok/shop/web/fetch_search_products_list_v2": { "get": { "description": "TikTok (shop/web).\n\n### Purpose:\n- Search products (Mobile API)\n- More streamlined data, faster response\n### Parameters:\n- search_word: Search keyword (required)\n- offset: Offset (default 0)\n- page_token: Page token\n- region: Region code (US/SG/MY/PH/TH/VN/ID/JP/MX)\n### Response Structure:\n```json\n{\n \"code\": 0,\n \"message\": \"success\",\n \"data\": {\n \"products\": [...], // Product list\n \"has_more\": true, // Has more\n \"load_more_params\": {} // Load more params\n }\n}\n```\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_shop_web_fetch_search_products_list_v2", "responses": { "200": { "description": "Successful Response\n\n### Response Structure\n```json\n{\n \"code\": 0,\n \"message\": \"success\",\n \"data\": {\n \"products\": [...], // Product list\n \"has_more\": true, // Has more\n \"load_more_params\": {} // Load more params\n }\n}\n```", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok web/fetch_search_products_list", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "bdc860ee374b" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/shop/web/fetch_search_products_list_v2", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_shop_web_fetch_search_products_list_v2", "method": "GET", "path": "/apis/v1/tikhub/tiktok/shop/web/fetch_search_products_list_v2" }, "parameters": [ { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "description": "Offset (default 0)", "default": 0, "title": "Offset" }, "description": "Offset (default 0)", "example": 0 }, { "name": "page_token", "in": "query", "required": false, "schema": { "type": "string", "description": "Page token", "default": "", "title": "Page Token" }, "description": "Page token", "example": "" }, { "name": "region", "in": "query", "required": false, "schema": { "type": "string", "description": "Region code: US, SG, MY, PH, TH, VN, ID, JP, or MX. GB and BR are unavailable. Unsupported regions return HTTP 200 with data.region_supported=false and supported_regions.", "default": "US", "title": "Region" }, "description": "Region code: US, SG, MY, PH, TH, VN, ID, JP, or MX. GB and BR are unavailable. Unsupported regions return HTTP 200 with data.region_supported=false and supported_regions.", "example": "US" }, { "name": "search_word", "in": "query", "required": true, "schema": { "type": "string", "description": "Search keyword", "title": "Search Word" }, "description": "Search keyword", "example": "labubu" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:4f13be099352e498e2ab88407efcaada133e58165b32a0cecf089e37581a0deb" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/shop/web/fetch_search_products_list_v2?offset=0&page_token=®ion=US&search_word=labubu' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-shop-web-fetch_search_products_list_v2" } }, "/apis/v1/tikhub/tiktok/shop/web/fetch_search_word_suggestion_v2": { "get": { "description": "TikTok (shop/web).\n\n### Purpose:\n- Get search keyword suggestions (Mobile API)\n- Optimized for e-commerce search results\n### Parameters:\n- search_word: Search keyword (required)\n- lang: Language code (en-US/zh-CN etc.)\n- region: Region code (US/SG/MY/PH/TH/VN/ID/JP/MX)\n### Important Notice:\n- Due to API rate limiting, please set request timeout to 30 seconds\n- If you encounter error code 400, please retry the request 3 times\n### Response Structure:\n```json\n{\n \"code\": 0,\n \"message\": \"\",\n \"data\": [ // Suggestion list (up to 50)\n \"keyword1\",\n \"keyword2\",\n \"...\"\n ]\n}\n```\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_shop_web_fetch_search_word_suggestion_v2", "responses": { "200": { "description": "Successful Response\n\n### Response Structure\n```json\n{\n \"code\": 0,\n \"message\": \"\",\n \"data\": [ // Suggestion list (up to 50)\n \"keyword1\",\n \"keyword2\",\n \"...\"\n ]\n}\n```", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok web/fetch_search_word_suggestion", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "b0805cfa426a" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/shop/web/fetch_search_word_suggestion_v2", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_shop_web_fetch_search_word_suggestion_v2", "method": "GET", "path": "/apis/v1/tikhub/tiktok/shop/web/fetch_search_word_suggestion_v2" }, "parameters": [ { "name": "lang", "in": "query", "required": false, "schema": { "type": "string", "description": "Language code (en-US/zh-CN etc.)", "default": "en-US", "title": "Lang" }, "description": "Language code (en-US/zh-CN etc.)", "example": "en-US" }, { "name": "region", "in": "query", "required": false, "schema": { "type": "string", "description": "Region code: US, SG, MY, PH, TH, VN, ID, JP, or MX. GB and BR are unavailable. Unsupported regions return HTTP 200 with data.region_supported=false and supported_regions.", "default": "US", "title": "Region" }, "description": "Region code: US, SG, MY, PH, TH, VN, ID, JP, or MX. GB and BR are unavailable. Unsupported regions return HTTP 200 with data.region_supported=false and supported_regions.", "example": "US" }, { "name": "search_word", "in": "query", "required": true, "schema": { "type": "string", "description": "Search keyword", "title": "Search Word" }, "description": "Search keyword", "example": "labubu" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:d901728e91d34e9b843f311cc550b21b57e4c7811aae523b5858ae76541e4f57" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/shop/web/fetch_search_word_suggestion_v2?lang=en-US®ion=US&search_word=labubu' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-shop-web-fetch_search_word_suggestion_v2" } }, "/apis/v1/tikhub/tiktok/shop/web/fetch_seller_products_list_v2": { "get": { "description": "TikTok (shop/web).\n\n### Purpose:\n- Get seller product list (Mobile API)\n- More streamlined data structure\n### Parameters:\n- seller_id: Seller ID (required)\n- searchParams: Search parameters (optional)\n- region: Region code (US/SG/MY/PH/TH/VN/ID/JP/MX)\n### Important Notice:\n- Due to API rate limiting, please set request timeout to 30 seconds\n- If you encounter error code 400, please retry the request 3 times\n### Response Structure:\n```json\n{\n \"code\": 0,\n \"message\": \"success\",\n \"data\": {\n \"products\": [...], // Product list\n \"has_more\": true, // Has more\n \"load_more_params\": {} // Load more params\n }\n}\n```\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_shop_web_fetch_seller_products_list_v2", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Response Structure\n```json\n{\n \"code\": 0,\n \"message\": \"success\",\n \"data\": {\n \"products\": [...], // Product list\n \"has_more\": true, // Has more\n \"load_more_params\": {} // Load more params\n }\n}\n```", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok web/fetch_seller_products_list", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "8fd789c4dda3" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/shop/web/fetch_seller_products_list_v2", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_shop_web_fetch_seller_products_list_v2", "method": "GET", "path": "/apis/v1/tikhub/tiktok/shop/web/fetch_seller_products_list_v2" }, "parameters": [ { "name": "region", "in": "query", "required": false, "schema": { "type": "string", "description": "Region code: US, SG, MY, PH, TH, VN, ID, JP, or MX. GB and BR are unavailable. Unsupported regions return HTTP 200 with data.region_supported=false and supported_regions.", "default": "US", "title": "Region" }, "description": "Region code: US, SG, MY, PH, TH, VN, ID, JP, or MX. GB and BR are unavailable. Unsupported regions return HTTP 200 with data.region_supported=false and supported_regions.", "example": "US" }, { "name": "searchParams", "in": "query", "required": false, "schema": { "type": "string", "description": "Search params", "default": "", "title": "Searchparams" }, "description": "Search params", "example": "" }, { "name": "seller_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Seller ID", "title": "Seller Id" }, "description": "Seller ID", "example": "7495150558072178725" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:1822a242d05bb4ed5b05f20e06650141081a14f6ffa243758ed97e255ba5f6ab" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/shop/web/fetch_seller_products_list_v2?region=US&searchParams=&seller_id=7495150558072178725' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-shop-web-fetch_seller_products_list_v2" } }, "/apis/v1/tikhub/tiktok/shop/web/fetch_shop_id_by_share_link": { "get": { "description": "TikTok (shop/web).\n\n### Purpose:\n- Get Shop ID by Share Link\n### Parameters:\n- share_link: Share link\n### Return:\n- Shop ID\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_shop_web_fetch_shop_id_by_share_link", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Shop ID", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok web/fetch_shop_id_by_share_link", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a205a341f8e7" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/shop/web/fetch_shop_id_by_share_link", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_shop_web_fetch_shop_id_by_share_link", "method": "GET", "path": "/apis/v1/tikhub/tiktok/shop/web/fetch_shop_id_by_share_link" }, "parameters": [ { "name": "region", "in": "query", "required": false, "schema": { "type": "string", "description": "地区代码：US/SG/MY/PH/TH/VN/ID/JP/MX；GB 和 BR 暂不支持 / Region code: US/SG/MY/PH/TH/VN/ID/JP/MX; GB and BR are unavailable", "default": "US", "title": "Region" }, "description": "地区代码：US/SG/MY/PH/TH/VN/ID/JP/MX；GB 和 BR 暂不支持 / Region code: US/SG/MY/PH/TH/VN/ID/JP/MX; GB and BR are unavailable", "example": "US" }, { "name": "share_link", "in": "query", "required": true, "schema": { "type": "string", "description": "Share link", "title": "Share Link" }, "description": "Share link", "example": "https://vt.tiktok.com/ZT2AHoGsE/" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:dc01373fda8adb30aed70f0f41646d7eaea46b0205d139182f2d6c421da67760" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/shop/web/fetch_shop_id_by_share_link?region=US&share_link=https%3A%2F%2Fvt.tiktok.com%2FZT2AHoGsE%2F' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-shop-web-fetch_shop_id_by_share_link" } }, "/apis/v1/tikhub/tiktok/web/decrypt_strData": { "get": { "description": "TikTok (web).\n\n### Purpose:\n- Decrypt strData fingerprint data to analyze fingerprint info in msToken request\n### Parameters:\n- encrypted_data: Encrypted strData string, obtained from browser packet capture\n### Return:\n- Decrypted raw fingerprint data, including browser fingerprint info and environment info, etc.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_web_decrypt_strData", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Decrypted raw fingerprint data, including browser fingerprint info and environment info, etc.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok decrypt_strData", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "689a2b448a37" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/decrypt_strData", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_web_decrypt_strData", "method": "GET", "path": "/apis/v1/tikhub/tiktok/web/decrypt_strData" }, "parameters": [ { "name": "encrypted_data", "in": "query", "required": true, "schema": { "type": "string", "description": "Encrypted strData string, obtained from browser packet capture", "title": "Encrypted Data" }, "description": "Encrypted strData string, obtained from browser packet capture", "example": "3BvqYbNXLLOcZehvxZVbjpAu7vq82RoWmFSJHLFwzDwJIZevE0AeilQfP55LridxmdGGjknoksqIsLqlMHMif0IFK/Br7JWqxOHnYuMwVCnttFc0Y4MFvdVWM5FECiEulJC0Dc+eeVsNSrFnAc9K7fazqdglyJgGLSfXIJmgyCvvQ4pg0u5HBVVugLSWs242X42fjoWymaUCLZJQo6vi6WLyuV7l5IC3Mg+lelr5xBQD6Q7hBIFEw8zzxJ1n2DyA4xLbOHTQdKvEtsK7XzyWwjpRnojPTbBl69Zosnuru+lOBIl+tFu/+hCQ1m0jYZwTP4rVE75L3Du6+KZ5v/9TyFYjq7y3y9bGLP4d7yQueJbF90G1yrZ6htElrZ2vqZKDrIqBVbmOZr/nph12k2JKrITtN0R/pMsp0sJ4gesQnXxcD/pLOFAINHk7umgbe6LzJ7+TLUdGuO4M7xiEg/jCqhjgJX1izZ4NPoBDp35zRxj6Y6OrcstlTN/cv5sz663+Nco/mEwhGq2VwrL4gAIAPycndIsb48dPdtngmLqNDNN0ZyVRjgqVIDXXrxigXCkR9CH89Dlrrb7QQqWVgRXz9/k5ihEM43BR3sd3mMU/XgFLN1Aoxf6GzzdxP2QPBI75/ZoHoAmu54v8gTmA3ntCGlEF0zgaFGTdpkGdb+oZgyQM4pw1aAyxmFINXkpD3IKKoGev9kD9gTFnhiQMGCMemhZS7ZYdbuGu0Cb+lQKaL/QTt80FMyGmW8kzVy9xW/ja9BcdEJYRoaufuFRkBFG5ay8x4WHLR6hEapXqQial/cREbLL4sQytpjtmnndFqvT7xN5DhgsLY2Z7451MJhD6NJXKNrMafGZSbItzQWY=" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:05a5b50750f86a2751aca870a848dbfd7ac851998593e575b94255cf15eaebd3" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/web/decrypt_strData?encrypted_data=3BvqYbNXLLOcZehvxZVbjpAu7vq82RoWmFSJHLFwzDwJIZevE0AeilQfP55LridxmdGGjknoksqIsLqlMHMif0IFK%2FBr7JWqxOHnYuMwVCnttFc0Y4MFvdVWM5FECiEulJC0Dc%2BeeVsNSrFnAc9K7fazqdglyJgGLSfXIJmgyCvvQ4pg0u5HBVVugLSWs242X42fjoWymaUCLZJQo6vi6WLyuV7l5IC3Mg%2Blelr5xBQD6Q7hBIFEw8zzxJ1n2DyA4xLbOHTQdKvEtsK7XzyWwjpRnojPTbBl69Zosnuru%2BlOBIl%2BtFu%2F%2BhCQ1m0jYZwTP4rVE75L3Du6%2BKZ5v%2F9TyFYjq7y3y9bGLP4d7yQueJbF90G1yrZ6htElrZ2vqZKDrIqBVbmOZr%2Fnph12k2JKrITtN0R%2FpMsp0sJ4gesQnXxcD%2FpLOFAINHk7umgbe6LzJ7%2BTLUdGuO4M7xiEg%2FjCqhjgJX1izZ4NPoBDp35zRxj6Y6OrcstlTN%2Fcv5sz663%2BNco%2FmEwhGq2VwrL4gAIAPycndIsb48dPdtngmLqNDNN0ZyVRjgqVIDXXrxigXCkR9CH89Dlrrb7QQqWVgRXz9%2Fk5ihEM43BR3sd3mMU%2FXgFLN1Aoxf6GzzdxP2QPBI75%2FZoHoAmu54v8gTmA3ntCGlEF0zgaFGTdpkGdb%2BoZgyQM4pw1aAyxmFINXkpD3IKKoGev9kD9gTFnhiQMGCMemhZS7ZYdbuGu0Cb%2BlQKaL%2FQTt80FMyGmW8kzVy9xW%2Fja9BcdEJYRoaufuFRkBFG5ay8x4WHLR6hEapXqQial%2FcREbLL4sQytpjtmnndFqvT7xN5DhgsLY2Z7451MJhD6NJXKNrMafGZSbItzQWY%3D' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-web-decrypt_strData" } }, "/apis/v1/tikhub/tiktok/web/device_register": { "get": { "description": "TikTok (web).\n\n### Purpose\n- Register device to generate device ID and guest Cookie for TikTok Web\n\n### Parameters\n- None\n\n### Return\n- Device registration information, including device ID and guest Cookie\n\n### Response\n```json\n{\n \"deviceId\": \"7556227929396708877\",\n \"cookie\": \"tt_chain_token=wBqjjz5I8m1bt96uxA1s8A==\",\n \"user_agent\": \"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/90.0.4430.212 Safari/537.36\"\n}\n```\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_web_device_register", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Device registration information, including device ID and guest Cookie\n\n### Response\n```json\n{\n \"deviceId\": \"7556227929396708877\",\n \"cookie\": \"tt_chain_token=wBqjjz5I8m1bt96uxA1s8A==\",\n \"user_agent\": \"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/90.0.4430.212 Safari/537.36\"\n}\n```", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok device_register", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "51822cacdf49" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/device_register", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_web_device_register", "method": "GET", "path": "/apis/v1/tikhub/tiktok/web/device_register" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:ee55890aeadb87a75d3e6b213f93b61c4a15706d60d106b9e06fb0f757b32c46" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-web-device_register" } }, "/apis/v1/tikhub/tiktok/web/encrypt_strData": { "get": { "description": "TikTok (web).\n\n### Purpose:\n- Encrypt strData fingerprint data for msToken request\n### Parameters:\n- data: Raw fingerprint data string (please convert JSON format to string before requesting)\n### Return:\n- Encrypted strData\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_web_encrypt_strData", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Encrypted strData", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok encrypt_strData", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "457df64e0154" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/encrypt_strData", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_web_encrypt_strData", "method": "GET", "path": "/apis/v1/tikhub/tiktok/web/encrypt_strData" }, "parameters": [ { "name": "data", "in": "query", "required": true, "schema": { "type": "string", "description": "Raw fingerprint data string (JSON format or dict string)", "title": "Data" }, "description": "Raw fingerprint data string (JSON format or dict string)", "example": "{\"behavior\":{\"beResize\":[],\"beMotion\":[{\"ts\":1701069187299,\"x\":null,\"y\":null,\"z\":null},{\"ts\":1701069202902,\"x\":null,\"y\":null,\"z\":null}],\"bePaste\":[],\"beMouse\":[],\"beKeyboard\":[],\"beScroll\":[],\"beTouch\":[],\"beWheel\":[],\"windowState\":[{\"ts\":1701069186257,\"v\":1},{\"ts\":1701069186257,\"v\":1},{\"ts\":1701069186388,\"v\":2},{\"ts\":1701069186388,\"v\":2},{\"ts\":1701069186402,\"v\":1},{\"ts\":1701069186402,\"v\":1},{\"ts\":1701069200309,\"v\":2},{\"ts\":1701069200309,\"v\":2},{\"ts\":1701069201865,\"v\":1},{\"ts\":1701069201865,\"v\":1}],\"isTrusted\":1},\"wID\":{\"sdkVersion\":\"4.4.6\",\"scmVersion\":\"1.0.0.96\",\"msgType\":2,\"timestamp\":\"1701069221819\",\"aid\":368462,\"aidList\":[1988,368462],\"privacyMode\":516},\"custom\":{},\"window\":{\"location\":\"https://www.tiktok.com/@funnykittensttk/video/7293517029737352454?is_from_webapp=1&web_id=7260049563725497899\"},\"msgMeta\":{\"msgType\":2,\"msgSrcProp\":2,\"msgProtocol\":1,\"aid\":368462,\"aidList\":[1988,368462]}}" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:6a5ced2451f8b9656434ffc5044a1ee86d9066509050f3631d77667a02616115" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/web/encrypt_strData?data=%7B%22behavior%22%3A%7B%22beResize%22%3A%5B%5D%2C%22beMotion%22%3A%5B%7B%22ts%22%3A1701069187299%2C%22x%22%3Anull%2C%22y%22%3Anull%2C%22z%22%3Anull%7D%2C%7B%22ts%22%3A1701069202902%2C%22x%22%3Anull%2C%22y%22%3Anull%2C%22z%22%3Anull%7D%5D%2C%22bePaste%22%3A%5B%5D%2C%22beMouse%22%3A%5B%5D%2C%22beKeyboard%22%3A%5B%5D%2C%22beScroll%22%3A%5B%5D%2C%22beTouch%22%3A%5B%5D%2C%22beWheel%22%3A%5B%5D%2C%22windowState%22%3A%5B%7B%22ts%22%3A1701069186257%2C%22v%22%3A1%7D%2C%7B%22ts%22%3A1701069186257%2C%22v%22%3A1%7D%2C%7B%22ts%22%3A1701069186388%2C%22v%22%3A2%7D%2C%7B%22ts%22%3A1701069186388%2C%22v%22%3A2%7D%2C%7B%22ts%22%3A1701069186402%2C%22v%22%3A1%7D%2C%7B%22ts%22%3A1701069186402%2C%22v%22%3A1%7D%2C%7B%22ts%22%3A1701069200309%2C%22v%22%3A2%7D%2C%7B%22ts%22%3A1701069200309%2C%22v%22%3A2%7D%2C%7B%22ts%22%3A1701069201865%2C%22v%22%3A1%7D%2C%7B%22ts%22%3A1701069201865%2C%22v%22%3A1%7D%5D%2C%22isTrusted%22%3A1%7D%2C%22wID%22%3A%7B%22sdkVersion%22%3A%224.4.6%22%2C%22scmVersion%22%3A%221.0.0.96%22%2C%22msgType%22%3A2%2C%22timestamp%22%3A%221701069221819%22%2C%22aid%22%3A368462%2C%22aidList%22%3A%5B1988%2C368462%5D%2C%22privacyMode%22%3A516%7D%2C%22custom%22%3A%7B%7D%2C%22window%22%3A%7B%22location%22%3A%22https%3A%2F%2Fwww.tiktok.com%2F%40funnykittensttk%2Fvideo%2F7293517029737352454%3Fis_from_webapp%3D1%26web_id%3D7260049563725497899%22%7D%2C%22msgMeta%22%3A%7B%22msgType%22%3A2%2C%22msgSrcProp%22%3A2%2C%22msgProtocol%22%3A1%2C%22aid%22%3A368462%2C%22aidList%22%3A%5B1988%2C368462%5D%7D%7D' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-web-encrypt_strData" } }, "/apis/v1/tikhub/tiktok/web/fetch_batch_check_live_alive": { "get": { "description": "TikTok (web). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Batch live room start status check\n- Support up to 50 live rooms query at once\n- If a live room does not exist or has ended, the corresponding position will return empty or null.\n\n### Parameters\n- room_ids: Live room ID list separated by commas, e.g.: 7530611486784277278,7530633767468288782\n\n### Return\n- Batch live room start status list\n\n### Price\nProvider usage depends on the number of live rooms queried; please try to query 50 live rooms to avoid wasting API call counts.\n\n### Note\n- The same room_id will not return the start status repeatedly.\n\n\nPublished reference price: $0.05 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_web_fetch_batch_check_live_alive", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Batch live room start status list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_batch_check_live_alive", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.05, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "f63b2099df6c" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/fetch_batch_check_live_alive", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_web_fetch_batch_check_live_alive", "method": "GET", "path": "/apis/v1/tikhub/tiktok/web/fetch_batch_check_live_alive" }, "parameters": [ { "name": "room_ids", "in": "query", "required": true, "schema": { "type": "string", "description": "Live room ID list separated by commas, up to 50 IDs\n\nUsage: Live room ID list separated by commas, e.g.: 7530611486784277278,7530633767468288782", "title": "Room Ids", "pattern": "^[^,]*(?:,[^,]*){0,49}$" }, "description": "Live room ID list separated by commas, up to 50 IDs\n\nUsage: Live room ID list separated by commas, e.g.: 7530611486784277278,7530633767468288782", "example": "7530611486784277278,7530633767468288782,7530636465034775310,7530604930088848142" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:932b6bab5c86901d4d134cd6e40d438ef06851b50dcc9278b107f39e4ef41f94" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/web/fetch_batch_check_live_alive?room_ids=7530611486784277278%2C7530633767468288782%2C7530636465034775310%2C7530604930088848142' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-web-fetch_batch_check_live_alive" } }, "/apis/v1/tikhub/tiktok/web/fetch_check_live_alive": { "get": { "description": "TikTok (web).\n\n### Purpose:\n- Live room start status check\n- If the current live room does not exist or has ended, it will return empty.\n### Parameters:\n- room_id: Live room ID\n### Return:\n- Live room start status\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_web_fetch_check_live_alive", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Live room start status", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_check_live_alive", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "059572060406" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/fetch_check_live_alive", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_web_fetch_check_live_alive", "method": "GET", "path": "/apis/v1/tikhub/tiktok/web/fetch_check_live_alive" }, "parameters": [ { "name": "room_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Live room ID", "title": "Room Id" }, "description": "Live room ID", "example": "7381444193462078214" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:43d833ff2897b41fe9244be10795e120543cc05122c0306a0f033c10934079af" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/web/fetch_check_live_alive?room_id=7381444193462078214' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-web-fetch_check_live_alive" } }, "/apis/v1/tikhub/tiktok/web/fetch_explore_post": { "get": { "description": "TikTok (web).\n\n### Purpose\n- Get explore video data\n\n### Parameters\n- categoryType: Video category\n - 100: Animation and comics\n - 101: Performance\n - 102: Beauty care\n - 103: Game\n - 104: Comedy\n - 105: Daily life\n - 106: Family\n - 107: Emotional relationship\n - 108: Drama\n - 109: Dress up\n - 110: Dubbing\n - 111: Food\n - 112: Sports\n - 113: Animals\n - 114: Society\n - 115: Car\n - 116: Education\n - 117: Fitness and health\n - 118: Technology\n - 119: Singing and dancing\n - 120: All\n- count: Number per page\n\n### Return\n- Video data\n\n### Note\n- The direct video CDN links returned by this interface require the returned `tt_chain_token` to be accessed, otherwise HTTP 403 will be returned.\n- When accessing a direct video CDN link, carry `Cookie: tt_chain_token={tt_chain_token}` in the request header, where `{tt_chain_token}` is the value returned by this interface.\n- **If a direct video CDN link still returns HTTP 403**:\n 1. Use the video link starting with `https://www.tiktok.com/aweme/v1/play/` from the response instead (found in the `UrlList` fields under `video`)\n 2. Send that link **without any Cookie** - carrying `tt_chain_token` will cause HTTP 403\n- If you need watermark-free video links that require no Cookie at all, use /tikhub/tiktok/app/v3/fetch_one_video.\n\nAPI references: `fetch_one_video` = `GET /tikhub/tiktok/app/v3/fetch_one_video` (operationId: `get_tikhub_tiktok_app_v3_fetch_one_video`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_web_fetch_explore_post", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Video data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_explore_post", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "201ce3298a71" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/fetch_explore_post", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_web_fetch_explore_post", "method": "GET", "path": "/apis/v1/tikhub/tiktok/web/fetch_explore_post" }, "parameters": [ { "name": "categoryType", "in": "query", "required": false, "schema": { "type": "string", "description": "Video category\n - 100: Animation and comics\n - 101: Performance\n - 102: Beauty care\n - 103: Game\n - 104: Comedy\n - 105: Daily life\n - 106: Family\n - 107: Emotional relationship\n - 108: Drama\n - 109: Dress up\n - 110: Dubbing\n - 111: Food\n - 112: Sports\n - 113: Animals\n - 114: Society\n - 115: Car\n - 116: Education\n - 117: Fitness and health\n - 118: Technology\n - 119: Singing and dancing\n - 120: All", "default": "120", "title": "Categorytype" }, "description": "Video category\n - 100: Animation and comics\n - 101: Performance\n - 102: Beauty care\n - 103: Game\n - 104: Comedy\n - 105: Daily life\n - 106: Family\n - 107: Emotional relationship\n - 108: Drama\n - 109: Dress up\n - 110: Dubbing\n - 111: Food\n - 112: Sports\n - 113: Animals\n - 114: Society\n - 115: Car\n - 116: Education\n - 117: Fitness and health\n - 118: Technology\n - 119: Singing and dancing\n - 120: All" }, { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number per page", "default": 16, "title": "Count" }, "description": "Number per page" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:77955fe0d15635857c070a6aa28493a874baf14b10f13e971e4bab6f9bc7a032" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-web-fetch_explore_post" } }, "/apis/v1/tikhub/tiktok/web/fetch_general_search": { "get": { "description": "TikTok (web).\n\n### Purpose\n- Get general search list\n\n### Parameters\n- keyword: Search keyword\n- offset: Page cursor, 0 for the first request, need to provide for the second paging, generally the keyword of this value is offset or cursor.\n- 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.\n - For example: search_id = \"20240828035554C02011379EBB6A00E00B\"\n - JSON Path-1 : $.data.extra.logid\n - JSON Path-2 : $.data.log_pb.impr_id\n- cookie: User cookie (If you need to search with your own account, or encounter an interface error, you can provide the cookie yourself, default is not required)\n\n### Return\n- General search list\n\n### Note\n- The direct video CDN links returned by this interface require the returned `tt_chain_token` to be accessed, otherwise HTTP 403 will be returned.\n- When accessing a direct video CDN link, carry `Cookie: tt_chain_token={tt_chain_token}` in the request header, where `{tt_chain_token}` is the value returned by this interface.\n- **If a direct video CDN link still returns HTTP 403**:\n 1. Use the video link starting with `https://www.tiktok.com/aweme/v1/play/` from the response instead (found in the `UrlList` fields under `video`)\n 2. Send that link **without any Cookie** - carrying `tt_chain_token` will cause HTTP 403\n- If you need watermark-free video links that require no Cookie at all, use /tikhub/tiktok/app/v3/fetch_one_video.\n\nAPI references: `fetch_one_video` = `GET /tikhub/tiktok/app/v3/fetch_one_video` (operationId: `get_tikhub_tiktok_app_v3_fetch_one_video`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_web_fetch_general_search", "responses": { "200": { "description": "Successful Response\n\n### Return\n- General search list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_general_search", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "25cc5b880d11" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/fetch_general_search", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_web_fetch_general_search", "method": "GET", "path": "/apis/v1/tikhub/tiktok/web/fetch_general_search" }, "parameters": [ { "name": "cookie", "in": "query", "required": false, "schema": { "type": "string", "description": "User cookie (if needed)\n\nUsage: User cookie (If you need to search with your own account, or encounter an interface error, you can provide the cookie yourself, default is not required)", "title": "Cookie" }, "description": "User cookie (if needed)\n\nUsage: User cookie (If you need to search with your own account, or encounter an interface error, you can provide the cookie yourself, default is not required)" }, { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Search keyword", "title": "Keyword" }, "description": "Search keyword", "example": "TikTok" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page cursor, 0 for the first request, need to provide for the second paging, generally the keyword of this value is offset or cursor.", "default": 0, "title": "Offset" }, "description": "Page cursor, 0 for the first request, need to provide for the second paging, generally the keyword of this value is offset or cursor." }, { "name": "search_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Search id, need to provide when paging\n\nUsage: 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.\n - For example: search_id = \"20240828035554C02011379EBB6A00E00B\"\n - JSON Path-1 : $.data.extra.logid\n - JSON Path-2 : $.data.log_pb.impr_id", "default": "", "title": "Search Id" }, "description": "Search id, need to provide when paging\n\nUsage: 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.\n - For example: search_id = \"20240828035554C02011379EBB6A00E00B\"\n - JSON Path-1 : $.data.extra.logid\n - JSON Path-2 : $.data.log_pb.impr_id" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:930cd229f8c2d33b5ad79274508d9e2ea8d0be681b5ffca5785a6fb90f1caf25" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/web/fetch_general_search?keyword=TikTok' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-web-fetch_general_search" } }, "/apis/v1/tikhub/tiktok/web/fetch_gift_name_by_id": { "post": { "description": "TikTok (web).\n\n### Purpose\nGet a gift name by TikTok gift ID.\n\n### Request body\nSend the gift_id in a JSON object, as defined by the request schema.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_tiktok_web_fetch_gift_name_by_id", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_gift_name_by_id", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "2548e7534682" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/fetch_gift_name_by_id", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_tiktok_web_fetch_gift_name_by_id", "method": "POST", "path": "/apis/v1/tikhub/tiktok/web/fetch_gift_name_by_id" }, "requestBody": { "content": { "application/json": { "schema": { "description": "Gift query parameters", "allOf": [ { "properties": { "gift_id": { "type": "string", "title": "Gift Id", "description": "Gift ID", "example": "10001" } }, "type": "object", "required": [ "gift_id" ], "title": "GiftQuery", "description": "Single Gift ID query model\n\nArgs:\n gift_id (str): Gift ID, e.g. \"10001\"" } ] } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e56c0f64759022cecb5502df30fd08faeb446c6d3a60cfc5fa77fb25dd390b27" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-tiktok-web-fetch_gift_name_by_id" } }, "/apis/v1/tikhub/tiktok/web/fetch_gift_names_by_ids": { "post": { "description": "TikTok (web). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\nGet gift names by multiple TikTok gift IDs.\n\n### Request body\nSend gift_ids in a JSON object, as defined by the request schema. Submit up to 50 IDs per call; if more are supplied, only the first 50 are processed.\n\n### Upstream pricing\n Use an AIsa price quote for gateway billing.\n\n\nPublished reference price: $0.025 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_tiktok_web_fetch_gift_names_by_ids", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_gift_names_by_ids", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.025, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "aaf31fcb7b8c" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/fetch_gift_names_by_ids", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_tiktok_web_fetch_gift_names_by_ids", "method": "POST", "path": "/apis/v1/tikhub/tiktok/web/fetch_gift_names_by_ids" }, "requestBody": { "content": { "application/json": { "schema": { "description": "Batch gift query parameters. Recommend 50 IDs per request for best value\n\nFor current API pricing, see the published x-aisa-pricing metadata. Where supported, obtain a quote for your exact request.", "allOf": [ { "properties": { "gift_ids": { "items": { "type": "string" }, "type": "array", "maxItems": 1000, "minItems": 1, "title": "Gift Ids", "description": "Gift ID list, recommend 50/call for best value , auto-process first 50 if more than 50\n\nFor current API pricing, see the published x-aisa-pricing metadata. Where supported, obtain a quote for your exact request.", "example": [ "10001", "10002", "10003" ] } }, "type": "object", "required": [ "gift_ids" ], "title": "BatchGiftQuery", "description": "Batch Gift ID query model\n recommended 50 IDs per request for best value\n\nArgs:\n gift_ids (list[str]): List of gift IDs, recommended 50 per request, e.g. [\"10001\", \"10002\", \"10003\"]\n\nFor current API pricing, see the published x-aisa-pricing metadata. Where supported, obtain a quote for your exact request." } ] } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e56c0f64759022cecb5502df30fd08faeb446c6d3a60cfc5fa77fb25dd390b27" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-tiktok-web-fetch_gift_names_by_ids" } }, "/apis/v1/tikhub/tiktok/web/fetch_home_feed": { "post": { "description": "TikTok (web).\n\n### Purpose\n- Home Feed\n\n### Parameters\n- count: Number per page\n- cookie: User's own cookie, optional parameter, used for personalized recommendations of interface return data.\n- region: Region code, optional parameter, affects the region of recommended content, e.g. US/GB/JP/KR/SG, default US.\n\n### Return\n- Home Feed\n\n### Note\n- The direct video CDN links returned by this interface require the returned `tt_chain_token` to be accessed, otherwise HTTP 403 will be returned.\n- When accessing a direct video CDN link, carry `Cookie: tt_chain_token={tt_chain_token}` in the request header, where `{tt_chain_token}` is the value returned by this interface.\n- **If a direct video CDN link still returns HTTP 403**:\n 1. Use the video link starting with `https://www.tiktok.com/aweme/v1/play/` from the response instead (found in the `UrlList` fields under `video`)\n 2. Send that link **without any Cookie** - carrying `tt_chain_token` will cause HTTP 403\n- If you need watermark-free video links that require no Cookie at all, use /tikhub/tiktok/app/v3/fetch_one_video.\n\nAPI references: `fetch_one_video` = `GET /tikhub/tiktok/app/v3/fetch_one_video` (operationId: `get_tikhub_tiktok_app_v3_fetch_one_video`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_tiktok_web_fetch_home_feed", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Home Feed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_home_feed", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "0927f002904d" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/fetch_home_feed", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_tiktok_web_fetch_home_feed", "method": "POST", "path": "/apis/v1/tikhub/tiktok/web/fetch_home_feed" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "count": { "type": "integer", "title": "Count", "description": "Number per page", "default": 15 }, "cookie": { "type": "string", "title": "Cookie", "description": "User's own cookie, optional parameter, used for personalized recommendations of interface return data." }, "region": { "type": "string", "title": "Region", "description": "Region code, optional parameter, affects the region of recommended content, e.g. US/GB/JP/KR/SG, default US.", "default": "US" } }, "type": "object", "title": "Body_fetch_home_feed_api_v1_tiktok_web_fetch_home_feed_post" } } } }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:fcfe81e2ec8e078e6eadb028787874159ce7c4f2315869a5a45a2e47059765d2" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-tiktok-web-fetch_home_feed" } }, "/apis/v1/tikhub/tiktok/web/fetch_live_gift_list": { "get": { "description": "TikTok (web).\n\n### Purpose\n- Get live room gift list\n- room_id is optional parameter, if not provided, will get general gift list (as of August 15, 2025, there are 256 types of gifts)\n\n### Parameters\n- room_id: Live room ID (optional)\n\n### Return\n- Live room gift list data\n\n### Note\n- The direct video CDN links returned by this interface require the returned `tt_chain_token` to be accessed, otherwise HTTP 403 will be returned.\n- When accessing a direct video CDN link, carry `Cookie: tt_chain_token={tt_chain_token}` in the request header, where `{tt_chain_token}` is the value returned by this interface.\n- **If a direct video CDN link still returns HTTP 403**:\n 1. Use the video link starting with `https://www.tiktok.com/aweme/v1/play/` from the response instead (found in the `UrlList` fields under `video`)\n 2. Send that link **without any Cookie** - carrying `tt_chain_token` will cause HTTP 403\n- If you need watermark-free video links that require no Cookie at all, use /tikhub/tiktok/app/v3/fetch_one_video.\n\nAPI references: `fetch_one_video` = `GET /tikhub/tiktok/app/v3/fetch_one_video` (operationId: `get_tikhub_tiktok_app_v3_fetch_one_video`).\n\n\nPublished reference price: $0.025 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_web_fetch_live_gift_list", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Live room gift list data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_live_gift_list", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.025, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "735d08d2bb79" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/fetch_live_gift_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_web_fetch_live_gift_list", "method": "GET", "path": "/apis/v1/tikhub/tiktok/web/fetch_live_gift_list" }, "parameters": [ { "name": "room_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Live room ID, optional parameter", "default": "", "title": "Room Id" }, "description": "Live room ID, optional parameter", "example": "7381444193462078214" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:ccfa478dd25e231e20ff431b470dbf50be85d0844d778988372822f95167a2dc" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-web-fetch_live_gift_list" } }, "/apis/v1/tikhub/tiktok/web/fetch_live_im_fetch": { "get": { "description": "TikTok (web).\n\n### Purpose:\n- TikTok live room danmaku parameters\n### Parameters:\n- room_id: Live room id\n- user_unique_id: User unique ID (optional)\n- resp_content_type: Response format, protobuf (default) or json\n\n### Return:\n- Danmaku parameter data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_web_fetch_live_im_fetch", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Danmaku parameter data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_live_im_fetch", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "6e70d5d55ffe" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/fetch_live_im_fetch", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_web_fetch_live_im_fetch", "method": "GET", "path": "/apis/v1/tikhub/tiktok/web/fetch_live_im_fetch" }, "parameters": [ { "name": "resp_content_type", "in": "query", "required": false, "schema": { "type": "string", "description": "Response format: protobuf or json", "default": "protobuf", "title": "Resp Content Type" }, "description": "Response format: protobuf or json", "example": "protobuf" }, { "name": "room_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Live room id", "title": "Room Id" }, "description": "Live room id", "example": "7382517534467115826" }, { "name": "user_unique_id", "in": "query", "required": false, "schema": { "type": "string", "description": "User unique ID", "title": "User Unique Id" }, "description": "User unique ID", "example": "7382524529011246630" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:7ccd3bbafcbaabbb137931192ee3d9b3480a25ab95b3da8fc1d65ab68ed1c8ec" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/web/fetch_live_im_fetch?resp_content_type=protobuf&room_id=7382517534467115826&user_unique_id=7382524529011246630' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-web-fetch_live_im_fetch" } }, "/apis/v1/tikhub/tiktok/web/fetch_live_recommend": { "get": { "description": "TikTok (web).\n\n### Purpose\n- Get live room homepage recommendation list\n\n### Parameters\n- related_live_tag: Related live tag (live category). The available values are not fixed; call `/tikhub/tiktok/web/fetch_live_recommend_tabs` first to get the currently available tag list, then pick one to pass in.\n\n### Return\n- Live room homepage recommendation list\n\n### Note\n- If you are not sure which values `related_live_tag` accepts, call `/tikhub/tiktok/web/fetch_live_recommend_tabs` to get the currently available tag (category tab) list.\n- The direct video CDN links returned by this interface require the returned `tt_chain_token` to be accessed, otherwise HTTP 403 will be returned.\n- When accessing a direct video CDN link, carry `Cookie: tt_chain_token={tt_chain_token}` in the request header, where `{tt_chain_token}` is the value returned by this interface.\n- **If a direct video CDN link still returns HTTP 403**:\n 1. Use the video link starting with `https://www.tiktok.com/aweme/v1/play/` from the response instead (found in the `UrlList` fields under `video`)\n 2. Send that link **without any Cookie** - carrying `tt_chain_token` will cause HTTP 403\n- If you need watermark-free video links that require no Cookie at all, use /tikhub/tiktok/app/v3/fetch_one_video.\n\nAPI references: `fetch_live_recommend_tabs` = `GET /tikhub/tiktok/web/fetch_live_recommend_tabs` (operationId: `get_tikhub_tiktok_web_fetch_live_recommend_tabs`); `fetch_one_video` = `GET /tikhub/tiktok/app/v3/fetch_one_video` (operationId: `get_tikhub_tiktok_app_v3_fetch_one_video`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_web_fetch_live_recommend", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Live room homepage recommendation list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_live_recommend", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "4aad34b364a2" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/fetch_live_recommend", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_web_fetch_live_recommend", "method": "GET", "path": "/apis/v1/tikhub/tiktok/web/fetch_live_recommend" }, "parameters": [ { "name": "related_live_tag", "in": "query", "required": true, "schema": { "type": "string", "description": "Related live tag (live category). The available values are not fixed; call `/tikhub/tiktok/web/fetch_live_recommend_tabs` first to get the currently available tag list, then pick one to pass in.\n\nAPI references: `fetch_live_recommend_tabs` = `GET /tikhub/tiktok/web/fetch_live_recommend_tabs` (operationId: `get_tikhub_tiktok_web_fetch_live_recommend_tabs`).", "title": "Related Live Tag" }, "description": "Related live tag (live category). The available values are not fixed; call `/tikhub/tiktok/web/fetch_live_recommend_tabs` first to get the currently available tag list, then pick one to pass in.\n\nAPI references: `fetch_live_recommend_tabs` = `GET /tikhub/tiktok/web/fetch_live_recommend_tabs` (operationId: `get_tikhub_tiktok_web_fetch_live_recommend_tabs`).", "example": "VALORANT" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:36454dc9567bae265e24744d26a0654d5be4777ba22a6b0d334bcbb1cf27a956" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/web/fetch_live_recommend?related_live_tag=VALORANT' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-web-fetch_live_recommend" } }, "/apis/v1/tikhub/tiktok/web/fetch_live_recommend_tabs": { "get": { "description": "TikTok (web).\n\n### Purpose\n- Get the available tag (live category tab) list for live room homepage recommendation\n- Works together with `/tikhub/tiktok/web/fetch_live_recommend` to discover the available values of its `related_live_tag` parameter\n\n### Parameters\n- logid: Pagination cursor. Leave empty for the first page; to load the next page, pass the `logid` value returned by the previous response\n\n### Return\n- Available tag (live category tab) list\n- logid: The log id of this request (from the `x-tt-logid` response header); pass it back as `logid` to load more\n\n### Note\n- The available values of `related_live_tag` are not fixed and may change by region/time, so it is recommended to fetch them in real time before use.\n\n### Pagination\n1. For the first request leave `logid` empty, and read the returned `logid` from the result.\n2. To load the next page, pass the previous `logid` back as the `logid` parameter (internally converted to TikTok's req_id).\n\nAPI references: `fetch_live_recommend` = `GET /tikhub/tiktok/web/fetch_live_recommend` (operationId: `get_tikhub_tiktok_web_fetch_live_recommend`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_web_fetch_live_recommend_tabs", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Available tag (live category tab) list\n- logid: The log id of this request (from the `x-tt-logid` response header); pass it back as `logid` to load more", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_live_recommend_tabs", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "2adedde6f06b" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/fetch_live_recommend_tabs", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_web_fetch_live_recommend_tabs", "method": "GET", "path": "/apis/v1/tikhub/tiktok/web/fetch_live_recommend_tabs" }, "parameters": [ { "name": "logid", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination cursor, leave empty for the first page; pass the `logid` from the previous response to load more", "default": "", "title": "Logid" }, "description": "Pagination cursor, leave empty for the first page; pass the `logid` from the previous response to load more", "example": "" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:b136655eb9f4900626cacd6a52df5fbc2e33da02c57c1ae577434b0f0b23a286" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-web-fetch_live_recommend_tabs" } }, "/apis/v1/tikhub/tiktok/web/fetch_post_ai_article": { "get": { "description": "TikTok (web).\n\n### Purpose:\n- Get the AI-generated article and content overview that TikTok generates from the video content\n- Useful for content analysis, topic research and SEO keyword mining\n### Parameters:\n- itemId: Video id\n### Return:\n- The `itemCustomTDK` field contains:\n - `title`: AI-generated title\n - `desc`: AI-generated content overview (summary)\n - `keywords`: AI-extracted keyword list\n - `article`: AI-generated article body based on the video content\n### Note:\n- Not every video has AI-generated content. If a video has none, the `itemCustomTDK` field is absent from the response.\n- Some videos only have `title`/`desc`/`keywords`, with `article` being an empty string.\n- The language of the article is determined by the video itself and is not affected by request parameters.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_web_fetch_post_ai_article", "responses": { "200": { "description": "Successful Response\n\n### Return\n- The `itemCustomTDK` field contains:\n - `title`: AI-generated title\n - `desc`: AI-generated content overview (summary)\n - `keywords`: AI-extracted keyword list\n - `article`: AI-generated article body based on the video content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_post_ai_article", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "e78d99390817" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/fetch_post_ai_article", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_web_fetch_post_ai_article", "method": "GET", "path": "/apis/v1/tikhub/tiktok/web/fetch_post_ai_article" }, "parameters": [ { "name": "itemId", "in": "query", "required": true, "schema": { "type": "string", "description": "Video id", "title": "Itemid" }, "description": "Video id", "example": "7651935877744168194" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:fed3a97d52eb97d4e3053ae9a9bab2f0145d9323b32fc02876ebf48feef22c94" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/web/fetch_post_ai_article?itemId=7651935877744168194' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-web-fetch_post_ai_article" } }, "/apis/v1/tikhub/tiktok/web/fetch_post_comment": { "get": { "description": "TikTok (web).\n\n### Purpose\n- Get video comments\n\n### Parameters\n- aweme_id: Video id\n- cursor: Page cursor\n- count: Number per page\n- current_region: Current region, default is empty.\n\n### Return\n- Video comments\n\n### Example\naweme_id = \"7304809083817774382\"\ncursor = 0\ncount = 20\ncurrent_region = \"\"\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_web_fetch_post_comment", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Video comments", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_post_comment", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "431979a8901d" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/fetch_post_comment", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_web_fetch_post_comment", "method": "GET", "path": "/apis/v1/tikhub/tiktok/web/fetch_post_comment" }, "parameters": [ { "name": "aweme_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Video id", "title": "Aweme Id" }, "description": "Video id", "example": "7304809083817774382" }, { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number per page", "default": 20, "title": "Count" }, "description": "Number per page" }, { "name": "current_region", "in": "query", "required": false, "schema": { "type": "string", "description": "Current region", "default": "", "title": "Current Region" }, "description": "Current region" }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page cursor", "default": 0, "title": "Cursor" }, "description": "Page cursor" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:5e729fa9930158e289a794c83c22151c73237d6594a42b17f269fec520f9dc07" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/web/fetch_post_comment?aweme_id=7304809083817774382' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-web-fetch_post_comment" } }, "/apis/v1/tikhub/tiktok/web/fetch_post_comment_reply": { "get": { "description": "TikTok (web).\n\n### Purpose\n- Get video comment replies\n\n### Parameters\n- item_id: Video id\n- comment_id: Comment id\n- cursor: Page cursor\n- count: Number per page\n- current_region: Current region, default is empty.\n\n### Return\n- Video comment replies\n\n### Example\nitem_id = \"7304809083817774382\"\ncomment_id = \"7304877760886588191\"\ncursor = 0\ncount = 20\ncurrent_region = \"\"\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_web_fetch_post_comment_reply", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Video comment replies", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_post_comment_reply", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "6ac6d2770908" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/fetch_post_comment_reply", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_web_fetch_post_comment_reply", "method": "GET", "path": "/apis/v1/tikhub/tiktok/web/fetch_post_comment_reply" }, "parameters": [ { "name": "comment_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Comment id", "title": "Comment Id" }, "description": "Comment id", "example": "7304877760886588191" }, { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number per page", "default": 20, "title": "Count" }, "description": "Number per page" }, { "name": "current_region", "in": "query", "required": false, "schema": { "type": "string", "description": "Current region", "default": "", "title": "Current Region" }, "description": "Current region" }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page cursor", "default": 0, "title": "Cursor" }, "description": "Page cursor" }, { "name": "item_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Video id", "title": "Item Id" }, "description": "Video id", "example": "7304809083817774382" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:6033cb7dd9642a9fab85e2aefb6534686719e86de571793ed5e2cc4777be2ae0" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/web/fetch_post_comment_reply?comment_id=7304877760886588191&item_id=7304809083817774382' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-web-fetch_post_comment_reply" } }, "/apis/v1/tikhub/tiktok/web/fetch_post_detail_v2": { "get": { "description": "TikTok (web).\n\n### Purpose:\n- Get single video data\n### Parameters:\n- itemId: Video id\n- region: Region code, optional; affects content region, e.g. US/GB/JP/ID, default US.\n### Return:\n- Video data\n### Note:\n- The video CDN links returned by this interface require the `tt_chain_token` from the response to be accessed, otherwise HTTP 403 will be returned.\n- When requesting a video CDN link, carry `Cookie: tt_chain_token={tt_chain_token}` in the request header, where `{tt_chain_token}` is the value returned in the response.\n- Example request header: `Cookie: tt_chain_token=xxx`\n- If you need video links that can be accessed **without any Cookie**, use `/fetch_post_detail`.\n\nUpstream-only reference: `fetch_post_detail` is `GET /api/v1/tiktok/web/fetch_post_detail` in the official API. It is not exposed as an operation in this specification.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_web_fetch_post_detail_v2", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Video data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_post_detail", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "1369ce9c4e7a" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/fetch_post_detail_v2", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_web_fetch_post_detail_v2", "method": "GET", "path": "/apis/v1/tikhub/tiktok/web/fetch_post_detail_v2" }, "parameters": [ { "name": "itemId", "in": "query", "required": true, "schema": { "type": "string", "description": "Video id", "title": "Itemid" }, "description": "Video id", "example": "7339393672959757570" }, { "name": "region", "in": "query", "required": false, "schema": { "type": "string", "description": "Region code, optional; affects content region, e.g. US/GB/JP/ID, default US.", "default": "US", "title": "Region" }, "description": "Region code, optional; affects content region, e.g. US/GB/JP/ID, default US." } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:77955fe0d15635857c070a6aa28493a874baf14b10f13e971e4bab6f9bc7a032" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/web/fetch_post_detail_v2?itemId=7339393672959757570' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-web-fetch_post_detail_v2" } }, "/apis/v1/tikhub/tiktok/web/fetch_search_keyword_suggest": { "get": { "description": "TikTok (web).\n\n### Purpose:\n- Search keyword suggest\n### Parameters:\n- keyword: Search keyword\n### Return:\n- Keyword suggest list\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_web_fetch_search_keyword_suggest", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Keyword suggest list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_search_keyword_suggest", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "43ecf5ccc3a6" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/fetch_search_keyword_suggest", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_web_fetch_search_keyword_suggest", "method": "GET", "path": "/apis/v1/tikhub/tiktok/web/fetch_search_keyword_suggest" }, "parameters": [ { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Search keyword", "title": "Keyword" }, "description": "Search keyword", "example": "TikTok" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:7706b0cb26e6feb7599aab02f1e925856a3c43a3ec4125ce84d024ba7a8469be" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/web/fetch_search_keyword_suggest?keyword=TikTok' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-web-fetch_search_keyword_suggest" } }, "/apis/v1/tikhub/tiktok/web/fetch_search_live": { "get": { "description": "TikTok (web).\n\n### Purpose:\n- Search live\n### Parameters:\n- keyword: Search keyword\n- count: Number per page\n- offset: Page offset, 0 for the first request, need to provide for the second paging.\n- 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.\n - For example: search_id = \"20240828035554C02011379EBB6A00E00B\"\n - JSON Path-1 : $.data.extra.logid\n - JSON Path-2 : $.data.log_pb.impr_id\n- cookie: User cookie (If you need to search with your own account, or encounter an interface error, you can provide the cookie yourself, default is not required)\n### Return:\n- Live list\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_web_fetch_search_live", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Live list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_search_live", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "82f61d110968" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/fetch_search_live", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_web_fetch_search_live", "method": "GET", "path": "/apis/v1/tikhub/tiktok/web/fetch_search_live" }, "parameters": [ { "name": "cookie", "in": "query", "required": false, "schema": { "type": "string", "description": "User cookie (if needed)\n\nUsage: User cookie (If you need to search with your own account, or encounter an interface error, you can provide the cookie yourself, default is not required)", "title": "Cookie" }, "description": "User cookie (if needed)\n\nUsage: User cookie (If you need to search with your own account, or encounter an interface error, you can provide the cookie yourself, default is not required)" }, { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number per page", "default": 20, "title": "Count" }, "description": "Number per page" }, { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Search keyword", "title": "Keyword" }, "description": "Search keyword", "example": "TikTok" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page cursor\n\nUsage: Page offset, 0 for the first request, need to provide for the second paging.", "default": 0, "title": "Offset" }, "description": "Page cursor\n\nUsage: Page offset, 0 for the first request, need to provide for the second paging." }, { "name": "search_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Search id, need to provide when paging\n\nUsage: 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.\n - For example: search_id = \"20240828035554C02011379EBB6A00E00B\"\n - JSON Path-1 : $.data.extra.logid\n - JSON Path-2 : $.data.log_pb.impr_id", "default": "", "title": "Search Id" }, "description": "Search id, need to provide when paging\n\nUsage: 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.\n - For example: search_id = \"20240828035554C02011379EBB6A00E00B\"\n - JSON Path-1 : $.data.extra.logid\n - JSON Path-2 : $.data.log_pb.impr_id" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:153f101b0682585ba1f2299348d4aef9cad28e3f734c14ead81d9c23fda595e1" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/web/fetch_search_live?keyword=TikTok' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-web-fetch_search_live" } }, "/apis/v1/tikhub/tiktok/web/fetch_search_photo": { "get": { "description": "TikTok (web).\n\n### Purpose:\n- Search photo\n### Parameters:\n- keyword: Search keyword\n- count: Number per page, it is recommended to keep the default value 20.\n- offset: Page cursor, 0 for the first request, need to provide for the second paging, generally the keyword of this value is offset or cursor.\n- 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.\n - For example: search_id = \"20240828035554C02011379EBB6A00E00B\"\n - JSON Path-1 : $.data.extra.logid\n - JSON Path-2 : $.data.log_pb.impr_id\n- offset: Page cursor\n- cookie: User cookie (If you need to search with your own account, or encounter an interface error, you can provide the cookie yourself, default is not required)\n### Return:\n- Video list\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_web_fetch_search_photo", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Video list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_search_photo", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "5ed33ef43762" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/fetch_search_photo", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_web_fetch_search_photo", "method": "GET", "path": "/apis/v1/tikhub/tiktok/web/fetch_search_photo" }, "parameters": [ { "name": "cookie", "in": "query", "required": false, "schema": { "type": "string", "description": "User cookie (if needed)\n\nUsage: User cookie (If you need to search with your own account, or encounter an interface error, you can provide the cookie yourself, default is not required)", "title": "Cookie" }, "description": "User cookie (if needed)\n\nUsage: User cookie (If you need to search with your own account, or encounter an interface error, you can provide the cookie yourself, default is not required)" }, { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number per page, it is recommended to keep the default value 20.", "default": 20, "title": "Count" }, "description": "Number per page, it is recommended to keep the default value 20." }, { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Search keyword", "title": "Keyword" }, "description": "Search keyword", "example": "TikTok" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page offset", "default": 0, "title": "Offset" }, "description": "Page offset" }, { "name": "search_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Search id, need to provide when paging\n\nUsage: 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.\n - For example: search_id = \"20240828035554C02011379EBB6A00E00B\"\n - JSON Path-1 : $.data.extra.logid\n - JSON Path-2 : $.data.log_pb.impr_id", "default": "", "title": "Search Id" }, "description": "Search id, need to provide when paging\n\nUsage: 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.\n - For example: search_id = \"20240828035554C02011379EBB6A00E00B\"\n - JSON Path-1 : $.data.extra.logid\n - JSON Path-2 : $.data.log_pb.impr_id" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:f97f25757ddb810d32a471da4bdc3fc73a86f1901f37cf06f4a45edd9b92a39d" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/web/fetch_search_photo?keyword=TikTok' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-web-fetch_search_photo" } }, "/apis/v1/tikhub/tiktok/web/fetch_search_user": { "get": { "description": "TikTok (web).\n\n### Purpose:\n- Search user\n### Parameters:\n- keyword: Search keyword\n- cursor: Page cursor, 0 for the first request, need to provide for the second paging, generally the keyword of this value is offset or cursor.\n- 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.\n - For example: search_id = \"20240828035554C02011379EBB6A00E00B\"\n - JSON Path-1 : $.data.extra.logid\n - JSON Path-2 : $.data.log_pb.impr_id\n- cookie: User cookie (If you need to search with your own account, or encounter an interface error, you can provide the cookie yourself, default is not required)\n### Return:\n- User list\n### Note:\n- If the `status_code` in the `data` field of the interface response is not 0, it means that the search request was not successful. Please check the exceptions in the response. You may be searching for keywords that TikTok does not allow, or searching for sensitive content. Please change the keywords and try again.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_web_fetch_search_user", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- User list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_search_user", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "2c50497c3355" }, "x-aisa-status": "disabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/fetch_search_user", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_web_fetch_search_user", "method": "GET", "path": "/apis/v1/tikhub/tiktok/web/fetch_search_user" }, "parameters": [ { "name": "cookie", "in": "query", "required": false, "schema": { "type": "string", "description": "User cookie (if needed)\n\nUsage: User cookie (If you need to search with your own account, or encounter an interface error, you can provide the cookie yourself, default is not required)", "title": "Cookie" }, "description": "User cookie (if needed)\n\nUsage: User cookie (If you need to search with your own account, or encounter an interface error, you can provide the cookie yourself, default is not required)" }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page cursor, 0 for the first request, need to provide for the second paging, generally the keyword of this value is offset or cursor.", "default": 0, "title": "Cursor" }, "description": "Page cursor, 0 for the first request, need to provide for the second paging, generally the keyword of this value is offset or cursor." }, { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Search keyword", "title": "Keyword" }, "description": "Search keyword", "example": "TikTok" }, { "name": "search_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Search id, need to provide when paging\n\nUsage: 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.\n - For example: search_id = \"20240828035554C02011379EBB6A00E00B\"\n - JSON Path-1 : $.data.extra.logid\n - JSON Path-2 : $.data.log_pb.impr_id", "default": "", "title": "Search Id" }, "description": "Search id, need to provide when paging\n\nUsage: 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.\n - For example: search_id = \"20240828035554C02011379EBB6A00E00B\"\n - JSON Path-1 : $.data.extra.logid\n - JSON Path-2 : $.data.log_pb.impr_id" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:21c781be53464c38ac41cbf3cad9be5de91ca1427450c9f29e454080020ac141" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/web/fetch_search_user?keyword=TikTok' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-web-fetch_search_user" } }, "/apis/v1/tikhub/tiktok/web/fetch_search_video": { "get": { "description": "TikTok (web).\n\n### Purpose:\n- Search video\n### Parameters:\n- keyword: Search keyword\n- count: Number per page, it is recommended to keep the default value 20.\n- offset: Page offset, 0 for the first request, need to provide for the second paging.\n- 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.\n - For example: search_id = \"20240828035554C02011379EBB6A00E00B\"\n - JSON Path-1 : $.data.extra.logid\n - JSON Path-2 : $.data.log_pb.impr_id\n- cookie: User cookie (If you need to search with your own account, or encounter an interface error, you can provide the cookie yourself, default is not required)\n### Return:\n- Video list\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_web_fetch_search_video", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Video list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_search_video", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "1b3deb09a8fb" }, "x-aisa-status": "disabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/fetch_search_video", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_web_fetch_search_video", "method": "GET", "path": "/apis/v1/tikhub/tiktok/web/fetch_search_video" }, "parameters": [ { "name": "cookie", "in": "query", "required": false, "schema": { "type": "string", "description": "User cookie (if needed)\n\nUsage: User cookie (If you need to search with your own account, or encounter an interface error, you can provide the cookie yourself, default is not required)", "title": "Cookie" }, "description": "User cookie (if needed)\n\nUsage: User cookie (If you need to search with your own account, or encounter an interface error, you can provide the cookie yourself, default is not required)" }, { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number per page, it is recommended to keep the default value 20.", "default": 20, "title": "Count" }, "description": "Number per page, it is recommended to keep the default value 20." }, { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Search keyword", "title": "Keyword" }, "description": "Search keyword", "example": "TikTok" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page cursor\n\nUsage: Page offset, 0 for the first request, need to provide for the second paging.", "default": 0, "title": "Offset" }, "description": "Page cursor\n\nUsage: Page offset, 0 for the first request, need to provide for the second paging." }, { "name": "search_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Search id, need to provide when paging\n\nUsage: 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.\n - For example: search_id = \"20240828035554C02011379EBB6A00E00B\"\n - JSON Path-1 : $.data.extra.logid\n - JSON Path-2 : $.data.log_pb.impr_id", "default": "", "title": "Search Id" }, "description": "Search id, need to provide when paging\n\nUsage: 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.\n - For example: search_id = \"20240828035554C02011379EBB6A00E00B\"\n - JSON Path-1 : $.data.extra.logid\n - JSON Path-2 : $.data.log_pb.impr_id" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:b8e73d36c678eb43ca28370b20159a186daa49a5dd1301d3a177f619c5ff61d7" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/web/fetch_search_video?keyword=TikTok' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-web-fetch_search_video" } }, "/apis/v1/tikhub/tiktok/web/fetch_tag_detail": { "get": { "description": "TikTok (web).\n\n### Purpose:\n- Tag Detail\n### Parameters:\n- tag_name: Tag name\n### Return:\n- Tag Detail\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_web_fetch_tag_detail", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Tag Detail", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_tag_detail", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "ed435c20f528" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/fetch_tag_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_web_fetch_tag_detail", "method": "GET", "path": "/apis/v1/tikhub/tiktok/web/fetch_tag_detail" }, "parameters": [ { "name": "tag_name", "in": "query", "required": true, "schema": { "type": "string", "description": "Tag name", "title": "Tag Name" }, "description": "Tag name", "example": "tiktok" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:9693d7df4144a9b31e983a5dd8b60d0cf8f92ed97963cfdc3f4ddc3705dbb948" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/web/fetch_tag_detail?tag_name=tiktok' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-web-fetch_tag_detail" } }, "/apis/v1/tikhub/tiktok/web/fetch_tag_post": { "get": { "description": "TikTok (web).\n\n### Purpose\n- Tag Post\n\n### Parameters\n- challengeID: Tag ID\n- count: Number per page\n- cursor: Page cursor\n\n### Return\n- Tag Post\n\n### Note\n- The direct video CDN links returned by this interface require the returned `tt_chain_token` to be accessed, otherwise HTTP 403 will be returned.\n- When accessing a direct video CDN link, carry `Cookie: tt_chain_token={tt_chain_token}` in the request header, where `{tt_chain_token}` is the value returned by this interface.\n- **If a direct video CDN link still returns HTTP 403**:\n 1. Use the video link starting with `https://www.tiktok.com/aweme/v1/play/` from the response instead (found in the `UrlList` fields under `video`)\n 2. Send that link **without any Cookie** - carrying `tt_chain_token` will cause HTTP 403\n- If you need watermark-free video links that require no Cookie at all, use /tikhub/tiktok/app/v3/fetch_one_video.\n\nAPI references: `fetch_one_video` = `GET /tikhub/tiktok/app/v3/fetch_one_video` (operationId: `get_tikhub_tiktok_app_v3_fetch_one_video`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_web_fetch_tag_post", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Tag Post", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_tag_post", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a16e74ce5ae6" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/fetch_tag_post", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_web_fetch_tag_post", "method": "GET", "path": "/apis/v1/tikhub/tiktok/web/fetch_tag_post" }, "parameters": [ { "name": "challengeID", "in": "query", "required": true, "schema": { "type": "string", "description": "Tag ID", "title": "Challengeid" }, "description": "Tag ID", "example": "7551" }, { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number per page", "default": 30, "title": "Count" }, "description": "Number per page" }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page cursor", "default": 0, "title": "Cursor" }, "description": "Page cursor" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:2adcd88c9e320685bba808e286f836a1f3e04be05dad2137d5b761bd10866f94" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/web/fetch_tag_post?challengeID=7551' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-web-fetch_tag_post" } }, "/apis/v1/tikhub/tiktok/web/fetch_tiktok_live_data": { "get": { "description": "TikTok (web).\n\n### Purpose:\n- Get live room information via live link\n- This interface can get offline live room information\n### Parameters:\n- live_room_url: Live room link\n### Return:\n- Live room information\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_web_fetch_tiktok_live_data", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Live room information", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_tiktok_live_data", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "d80f757d7605" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/fetch_tiktok_live_data", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_web_fetch_tiktok_live_data", "method": "GET", "path": "/apis/v1/tikhub/tiktok/web/fetch_tiktok_live_data" }, "parameters": [ { "name": "live_room_url", "in": "query", "required": true, "schema": { "type": "string", "description": "Live room link", "title": "Live Room Url" }, "description": "Live room link", "example": "https://www.tiktok.com/@.caseoh_daily/live" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:16204f6955408b74d468748d36d0f3f15256aa022f75f57f3e10af8c2489d0c1" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/web/fetch_tiktok_live_data?live_room_url=https%3A%2F%2Fwww.tiktok.com%2F%40.caseoh_daily%2Flive' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-web-fetch_tiktok_live_data" } }, "/apis/v1/tikhub/tiktok/web/fetch_tiktok_web_guest_cookie": { "get": { "description": "TikTok (web).\n\n### Purpose:\n- Get the guest Cookie of TikTok Web\n- Can be used to crawl data of TikTok Web, such as user videos, mix videos, etc.\n- Can fix identity to avoid duplicate data for some interfaces.\n- Please note: Guest Cookie cannot crawl all data, there are certain restrictions.\n- Can be used with open source projects to implement data crawling of TikTok Web using this interface.\n### Parameters:\n- user_agent: User browser agent\n### Return:\n- Guest Cookie\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_web_fetch_tiktok_web_guest_cookie", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Guest Cookie", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_tiktok_web_guest_cookie", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "714f6dc7ebf6" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/fetch_tiktok_web_guest_cookie", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_web_fetch_tiktok_web_guest_cookie", "method": "GET", "path": "/apis/v1/tikhub/tiktok/web/fetch_tiktok_web_guest_cookie" }, "parameters": [ { "name": "user_agent", "in": "query", "required": true, "schema": { "type": "string", "description": "User browser agent", "title": "User Agent" }, "description": "User browser agent", "example": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/90.0.4430.212 Safari/537.36" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:06cff03bcdfd7f5481a26196842e519bd07cca9931b9f821a22aff5e11eac175" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/web/fetch_tiktok_web_guest_cookie?user_agent=Mozilla%2F5.0+%28Windows+NT+10.0%3B+Win64%3B+x64%29+AppleWebKit%2F537.36+%28KHTML%2C+like+Gecko%29+Chrome%2F90.0.4430.212+Safari%2F537.36' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-web-fetch_tiktok_web_guest_cookie" } }, "/apis/v1/tikhub/tiktok/web/fetch_trending_searchwords": { "get": { "description": "TikTok (web).\n\n### Purpose:\n- Get daily trending search words\n### Return:\n- Trending search words\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_web_fetch_trending_searchwords", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Trending search words", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_trending_searchwords", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "ab098964ab00" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/fetch_trending_searchwords", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_web_fetch_trending_searchwords", "method": "GET", "path": "/apis/v1/tikhub/tiktok/web/fetch_trending_searchwords" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:2694ec3faba43ca2143bcfee97efd4eae2d9fd1a5b4d191857445a83f74d8411" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-web-fetch_trending_searchwords" } }, "/apis/v1/tikhub/tiktok/web/fetch_user_collect": { "get": { "description": "TikTok (web).\n\n### Purpose\n- Get user favorites\n- Note: This interface can currently only get your own favorites list, you need to provide your account cookie.\n\n### Parameters\n- cookie: User cookie\n- secUid: User secUid\n- cursor: Page cursor\n- count: Number per page\n- coverFormat: Cover format\n\n### Return\n- User favorites\n\n### Note\n- The direct video CDN links returned by this interface require the returned `tt_chain_token` to be accessed, otherwise HTTP 403 will be returned.\n- When accessing a direct video CDN link, carry `Cookie: tt_chain_token={tt_chain_token}` in the request header, where `{tt_chain_token}` is the value returned by this interface.\n- **If a direct video CDN link still returns HTTP 403**:\n 1. Use the video link starting with `https://www.tiktok.com/aweme/v1/play/` from the response instead (found in the `UrlList` fields under `video`)\n 2. Send that link **without any Cookie** - carrying `tt_chain_token` will cause HTTP 403\n- If you need watermark-free video links that require no Cookie at all, use /tikhub/tiktok/app/v3/fetch_one_video.\n\nAPI references: `fetch_one_video` = `GET /tikhub/tiktok/app/v3/fetch_one_video` (operationId: `get_tikhub_tiktok_app_v3_fetch_one_video`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_web_fetch_user_collect", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- User favorites", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_user_collect", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "81674b5703e4" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/fetch_user_collect", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_web_fetch_user_collect", "method": "GET", "path": "/apis/v1/tikhub/tiktok/web/fetch_user_collect" }, "parameters": [ { "name": "cookie", "in": "query", "required": true, "schema": { "type": "string", "description": "User cookie", "title": "Cookie" }, "description": "User cookie", "example": "Your_Cookie" }, { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number per page", "default": 30, "title": "Count" }, "description": "Number per page" }, { "name": "coverFormat", "in": "query", "required": false, "schema": { "type": "integer", "description": "Cover format", "default": 2, "title": "Coverformat" }, "description": "Cover format" }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page cursor", "default": 0, "title": "Cursor" }, "description": "Page cursor" }, { "name": "secUid", "in": "query", "required": true, "schema": { "type": "string", "description": "User secUid", "title": "Secuid" }, "description": "User secUid", "example": "Your_SecUid" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:fc6fe0a0372d47f85e3a51173c0b9705ba685c7a1d1beaeac20e65e33c1cde2c" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/web/fetch_user_collect?cookie=Your_Cookie&secUid=Your_SecUid' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-web-fetch_user_collect" } }, "/apis/v1/tikhub/tiktok/web/fetch_user_fans": { "get": { "description": "TikTok (web).\n\n### Purpose\n- Get user followers\n\n### Parameters\n- secUid: User secUid\n- count: Number per page\n- maxCursor: Max cursor\n- minCursor: Min cursor\n\n### Return\n- User followers\n\n### Note\n- The direct video CDN links returned by this interface require the returned `tt_chain_token` to be accessed, otherwise HTTP 403 will be returned.\n- When accessing a direct video CDN link, carry `Cookie: tt_chain_token={tt_chain_token}` in the request header, where `{tt_chain_token}` is the value returned by this interface.\n- **If a direct video CDN link still returns HTTP 403**:\n 1. Use the video link starting with `https://www.tiktok.com/aweme/v1/play/` from the response instead (found in the `UrlList` fields under `video`)\n 2. Send that link **without any Cookie** - carrying `tt_chain_token` will cause HTTP 403\n- If you need watermark-free video links that require no Cookie at all, use /tikhub/tiktok/app/v3/fetch_one_video.\n\nAPI references: `fetch_one_video` = `GET /tikhub/tiktok/app/v3/fetch_one_video` (operationId: `get_tikhub_tiktok_app_v3_fetch_one_video`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_web_fetch_user_fans", "responses": { "200": { "description": "Successful Response\n\n### Return\n- User followers", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_user_fans", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "4c0ee3c4f228" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/fetch_user_fans", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_web_fetch_user_fans", "method": "GET", "path": "/apis/v1/tikhub/tiktok/web/fetch_user_fans" }, "parameters": [ { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number per page", "default": 30, "title": "Count" }, "description": "Number per page" }, { "name": "maxCursor", "in": "query", "required": false, "schema": { "type": "integer", "description": "Max cursor", "default": 0, "title": "Maxcursor" }, "description": "Max cursor" }, { "name": "minCursor", "in": "query", "required": false, "schema": { "type": "integer", "description": "Min cursor", "default": 0, "title": "Mincursor" }, "description": "Min cursor" }, { "name": "secUid", "in": "query", "required": true, "schema": { "type": "string", "description": "User secUid", "title": "Secuid" }, "description": "User secUid", "example": "MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:eb33ffc4a59cc69e5102b85f197f6b20c01c44256780a69bcb39f0a2a2ec1a87" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/web/fetch_user_fans?secUid=MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-web-fetch_user_fans" } }, "/apis/v1/tikhub/tiktok/web/fetch_user_follow": { "get": { "description": "TikTok (web).\n\n### Purpose\n- Get user followings\n\n### Parameters\n- secUid: User secUid\n- count: Number per page\n- maxCursor: Max cursor\n- minCursor: Min cursor\n\n### Return\n- User followings\n\n### Note\n- The direct video CDN links returned by this interface require the returned `tt_chain_token` to be accessed, otherwise HTTP 403 will be returned.\n- When accessing a direct video CDN link, carry `Cookie: tt_chain_token={tt_chain_token}` in the request header, where `{tt_chain_token}` is the value returned by this interface.\n- **If a direct video CDN link still returns HTTP 403**:\n 1. Use the video link starting with `https://www.tiktok.com/aweme/v1/play/` from the response instead (found in the `UrlList` fields under `video`)\n 2. Send that link **without any Cookie** - carrying `tt_chain_token` will cause HTTP 403\n- If you need watermark-free video links that require no Cookie at all, use /tikhub/tiktok/app/v3/fetch_one_video.\n\nAPI references: `fetch_one_video` = `GET /tikhub/tiktok/app/v3/fetch_one_video` (operationId: `get_tikhub_tiktok_app_v3_fetch_one_video`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_web_fetch_user_follow", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- User followings", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_user_follow", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "ae34ddf8f624" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/fetch_user_follow", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_web_fetch_user_follow", "method": "GET", "path": "/apis/v1/tikhub/tiktok/web/fetch_user_follow" }, "parameters": [ { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number per page", "default": 30, "title": "Count" }, "description": "Number per page" }, { "name": "maxCursor", "in": "query", "required": false, "schema": { "type": "integer", "description": "Max cursor", "default": 0, "title": "Maxcursor" }, "description": "Max cursor" }, { "name": "minCursor", "in": "query", "required": false, "schema": { "type": "integer", "description": "Min cursor", "default": 0, "title": "Mincursor" }, "description": "Min cursor" }, { "name": "secUid", "in": "query", "required": true, "schema": { "type": "string", "description": "User secUid", "title": "Secuid" }, "description": "User secUid", "example": "MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:f89c90ca82d5d26b012373fe207b7f003fe864982797baedd153f4af2d751cc3" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/web/fetch_user_follow?secUid=MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-web-fetch_user_follow" } }, "/apis/v1/tikhub/tiktok/web/fetch_user_like": { "get": { "description": "TikTok (web).\n\n### Purpose\n- Get user likes\n- Note: This interface requires that the user's like list be public\n\n### Parameters\n- secUid: User secUid\n- cursor: Page cursor\n- count: Number per page, default is 20, cannot be changed.\n- coverFormat: Cover format\n- post_item_list_request_type: Sort type\n - 0: Default sort\n - 1: Hot sort\n - 2: Oldest sort\n\n### Return\n- User likes\n\n### Note\n- The direct video CDN links returned by this interface require the returned `tt_chain_token` to be accessed, otherwise HTTP 403 will be returned.\n- When accessing a direct video CDN link, carry `Cookie: tt_chain_token={tt_chain_token}` in the request header, where `{tt_chain_token}` is the value returned by this interface.\n- **If a direct video CDN link still returns HTTP 403**:\n 1. Use the video link starting with `https://www.tiktok.com/aweme/v1/play/` from the response instead (found in the `UrlList` fields under `video`)\n 2. Send that link **without any Cookie** - carrying `tt_chain_token` will cause HTTP 403\n- If you need watermark-free video links that require no Cookie at all, use /tikhub/tiktok/app/v3/fetch_one_video.\n\nAPI references: `fetch_one_video` = `GET /tikhub/tiktok/app/v3/fetch_one_video` (operationId: `get_tikhub_tiktok_app_v3_fetch_one_video`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_web_fetch_user_like", "responses": { "200": { "description": "Successful Response\n\n### Return\n- User likes", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_user_like", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "df20529a8b1a" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/fetch_user_like", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_web_fetch_user_like", "method": "GET", "path": "/apis/v1/tikhub/tiktok/web/fetch_user_like" }, "parameters": [ { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number per page, default is 20, cannot be changed.", "default": 20, "title": "Count" }, "description": "Number per page, default is 20, cannot be changed." }, { "name": "coverFormat", "in": "query", "required": false, "schema": { "type": "integer", "description": "Cover format", "default": 2, "title": "Coverformat" }, "description": "Cover format" }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page cursor", "default": 0, "title": "Cursor" }, "description": "Page cursor" }, { "name": "post_item_list_request_type", "in": "query", "required": false, "schema": { "type": "integer", "description": "Sort type\n - 0: Default sort\n - 1: Hot sort\n - 2: Oldest sort", "default": 0, "title": "Post Item List Request Type" }, "description": "Sort type\n - 0: Default sort\n - 1: Hot sort\n - 2: Oldest sort" }, { "name": "secUid", "in": "query", "required": true, "schema": { "type": "string", "description": "User secUid", "title": "Secuid" }, "description": "User secUid", "example": "MS4wLjABAAAAq1iRXNduFZpY301UkVpJ1eQT60_NiWS9QQSeNqmNQEDJp0pOF8cpleNEdiJx5_IU" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:c1e5054549e4713dca8bc634ccf5ac58d087b8981abf2a43085acc3cd2dede58" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/web/fetch_user_like?secUid=MS4wLjABAAAAq1iRXNduFZpY301UkVpJ1eQT60_NiWS9QQSeNqmNQEDJp0pOF8cpleNEdiJx5_IU' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-web-fetch_user_like" } }, "/apis/v1/tikhub/tiktok/web/fetch_user_live_detail": { "get": { "description": "TikTok (web).\n\n### Purpose\n- Get user live details\n\n### Parameters\n- uniqueId: User uniqueId\n\n### Return\n- User live details\n\n### Note\n- The direct video CDN links returned by this interface require the returned `tt_chain_token` to be accessed, otherwise HTTP 403 will be returned.\n- When accessing a direct video CDN link, carry `Cookie: tt_chain_token={tt_chain_token}` in the request header, where `{tt_chain_token}` is the value returned by this interface.\n- **If a direct video CDN link still returns HTTP 403**:\n 1. Use the video link starting with `https://www.tiktok.com/aweme/v1/play/` from the response instead (found in the `UrlList` fields under `video`)\n 2. Send that link **without any Cookie** - carrying `tt_chain_token` will cause HTTP 403\n- If you need watermark-free video links that require no Cookie at all, use /tikhub/tiktok/app/v3/fetch_one_video.\n\nAPI references: `fetch_one_video` = `GET /tikhub/tiktok/app/v3/fetch_one_video` (operationId: `get_tikhub_tiktok_app_v3_fetch_one_video`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_web_fetch_user_live_detail", "responses": { "200": { "description": "Successful Response\n\n### Return\n- User live details", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_user_live_detail", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "4e67298e83ed" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/fetch_user_live_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_web_fetch_user_live_detail", "method": "GET", "path": "/apis/v1/tikhub/tiktok/web/fetch_user_live_detail" }, "parameters": [ { "name": "uniqueId", "in": "query", "required": true, "schema": { "type": "string", "description": "User uniqueId", "title": "Uniqueid" }, "description": "User uniqueId", "example": "tiktok" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e00e186bd8d36740edf0681fc267d82d5ed62f8946571a749a5fd0182c36f640" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/web/fetch_user_live_detail?uniqueId=tiktok' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-web-fetch_user_live_detail" } }, "/apis/v1/tikhub/tiktok/web/fetch_user_mix": { "get": { "description": "TikTok (web).\n\n### Purpose\n- Get user mix list\n\n### Parameters\n- mixId: Mix id\n- cursor: Page cursor\n- count: Number per page\n\n### Return\n- User mix list\n\n### Note\n- The direct video CDN links returned by this interface require the returned `tt_chain_token` to be accessed, otherwise HTTP 403 will be returned.\n- When accessing a direct video CDN link, carry `Cookie: tt_chain_token={tt_chain_token}` in the request header, where `{tt_chain_token}` is the value returned by this interface.\n- **If a direct video CDN link still returns HTTP 403**:\n 1. Use the video link starting with `https://www.tiktok.com/aweme/v1/play/` from the response instead (found in the `UrlList` fields under `video`)\n 2. Send that link **without any Cookie** - carrying `tt_chain_token` will cause HTTP 403\n- If you need watermark-free video links that require no Cookie at all, use /tikhub/tiktok/app/v3/fetch_one_video.\n\n### Example\nmixId = \"7101538765474106158\"\ncursor = 0\ncount = 30\n\nAPI references: `fetch_one_video` = `GET /tikhub/tiktok/app/v3/fetch_one_video` (operationId: `get_tikhub_tiktok_app_v3_fetch_one_video`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_web_fetch_user_mix", "responses": { "200": { "description": "Successful Response\n\n### Return\n- User mix list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_user_mix", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "44ca41e75efe" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/fetch_user_mix", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_web_fetch_user_mix", "method": "GET", "path": "/apis/v1/tikhub/tiktok/web/fetch_user_mix" }, "parameters": [ { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number per page", "default": 30, "title": "Count" }, "description": "Number per page" }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page cursor", "default": 0, "title": "Cursor" }, "description": "Page cursor" }, { "name": "mixId", "in": "query", "required": true, "schema": { "type": "string", "description": "Mix id", "title": "Mixid" }, "description": "Mix id", "example": "7101538765474106158" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:08040836b41f35ebc80a16507c9c9e1252b88e34e1cdc27a49e409fadc580d0d" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/web/fetch_user_mix?mixId=7101538765474106158' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-web-fetch_user_mix" } }, "/apis/v1/tikhub/tiktok/web/fetch_user_play_list": { "get": { "description": "TikTok (web).\n\n### Purpose\n- Get user play list\n\n### Parameters\n- secUid: User secUid\n- cursor: Page cursor\n- count: Number per page\n\n### Return\n- User play list\n\n### Note\n- The direct video CDN links returned by this interface require the returned `tt_chain_token` to be accessed, otherwise HTTP 403 will be returned.\n- When accessing a direct video CDN link, carry `Cookie: tt_chain_token={tt_chain_token}` in the request header, where `{tt_chain_token}` is the value returned by this interface.\n- **If a direct video CDN link still returns HTTP 403**:\n 1. Use the video link starting with `https://www.tiktok.com/aweme/v1/play/` from the response instead (found in the `UrlList` fields under `video`)\n 2. Send that link **without any Cookie** - carrying `tt_chain_token` will cause HTTP 403\n- If you need watermark-free video links that require no Cookie at all, use /tikhub/tiktok/app/v3/fetch_one_video.\n\n### Example\nsecUid = \"MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM\"\ncursor = 0\ncount = 30\n\nAPI references: `fetch_one_video` = `GET /tikhub/tiktok/app/v3/fetch_one_video` (operationId: `get_tikhub_tiktok_app_v3_fetch_one_video`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_web_fetch_user_play_list", "responses": { "200": { "description": "Successful Response\n\n### Return\n- User play list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_user_play_list", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "199ce2c8cabc" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/fetch_user_play_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_web_fetch_user_play_list", "method": "GET", "path": "/apis/v1/tikhub/tiktok/web/fetch_user_play_list" }, "parameters": [ { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number per page", "default": 30, "title": "Count" }, "description": "Number per page" }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page cursor", "default": 0, "title": "Cursor" }, "description": "Page cursor" }, { "name": "secUid", "in": "query", "required": true, "schema": { "type": "string", "description": "User secUid", "title": "Secuid" }, "description": "User secUid", "example": "MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:d7d858e46dae4b31a39ef0179e0a919f4de4e8140bcc8bb6c93e874bf7289397" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/web/fetch_user_play_list?secUid=MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-web-fetch_user_play_list" } }, "/apis/v1/tikhub/tiktok/web/fetch_user_post": { "get": { "description": "TikTok (web).\n\n### Purpose\n- Get user posts\n\n### Parameters\n- secUid: User secUid\n- cursor: Page cursor. Pass 0 for the first request, then pass the `cursor` value returned by the previous response.\n- count: Number per page, default is 15, maximum is 15. Values above 15 are treated as 15.\n- coverFormat: Cover format, default is 2, optional values are 1 or 2.\n- post_item_list_request_type: Sort type. Deprecated - any value returns posts ordered from newest to oldest.\n\n### Return\n- User posts, ordered from newest to oldest\n- `cursor`: Cursor for the next page, use together with `hasMore`\n- `hasMore`: Whether more posts are available; `false` means the last page has been reached\n- Consecutive pages may contain a few overlapping posts; de-duplicate by post `id` before counting or storing\n\n### Note\n- The direct video CDN links returned by this interface require the returned `tt_chain_token` to be accessed, otherwise HTTP 403 will be returned.\n- When accessing a direct video CDN link, carry `Cookie: tt_chain_token={tt_chain_token}` in the request header, where `{tt_chain_token}` is the value returned by this interface.\n- **If a direct video CDN link still returns HTTP 403**:\n 1. Use the video link starting with `https://www.tiktok.com/aweme/v1/play/` from the response instead (found in the `UrlList` fields under `video`)\n 2. Send that link **without any Cookie** - carrying `tt_chain_token` will cause HTTP 403\n- If you need watermark-free video links that require no Cookie at all, use /tikhub/tiktok/app/v3/fetch_one_video.\n\nAPI references: `fetch_one_video` = `GET /tikhub/tiktok/app/v3/fetch_one_video` (operationId: `get_tikhub_tiktok_app_v3_fetch_one_video`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_web_fetch_user_post", "responses": { "200": { "description": "Successful Response\n\n### Return\n- User posts, ordered from newest to oldest\n- `cursor`: Cursor for the next page, use together with `hasMore`\n- `hasMore`: Whether more posts are available; `false` means the last page has been reached\n- Consecutive pages may contain a few overlapping posts; de-duplicate by post `id` before counting or storing", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_user_post", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "b78a01e35ae5" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/fetch_user_post", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_web_fetch_user_post", "method": "GET", "path": "/apis/v1/tikhub/tiktok/web/fetch_user_post" }, "parameters": [ { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number per page, max 15\n\nUsage: Number per page, default is 15, maximum is 15. Values above 15 are treated as 15.", "default": 15, "title": "Count" }, "description": "Number per page, max 15\n\nUsage: Number per page, default is 15, maximum is 15. Values above 15 are treated as 15.", "example": 15 }, { "name": "coverFormat", "in": "query", "required": false, "schema": { "type": "integer", "description": "Cover format, default is 2, optional values are 1 or 2.", "default": 2, "title": "Coverformat" }, "description": "Cover format, default is 2, optional values are 1 or 2.", "example": 2 }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "description": "Page cursor. Pass 0 for the first request, then pass the `cursor` value returned by the previous response.", "default": 0, "title": "Cursor" }, "description": "Page cursor. Pass 0 for the first request, then pass the `cursor` value returned by the previous response.", "example": 0 }, { "name": "post_item_list_request_type", "in": "query", "required": false, "schema": { "type": "integer", "description": "Sort type (deprecated, no longer effective)\n\nUsage: Sort type. Deprecated - any value returns posts ordered from newest to oldest.", "default": 0, "title": "Post Item List Request Type" }, "description": "Sort type (deprecated, no longer effective)\n\nUsage: Sort type. Deprecated - any value returns posts ordered from newest to oldest.", "example": 0 }, { "name": "secUid", "in": "query", "required": true, "schema": { "type": "string", "description": "User secUid", "title": "Secuid" }, "description": "User secUid", "example": "MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e30790947edfb4c13043b9297ec8ceaa6f4d33998686edfcba5be37999596d1b" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/web/fetch_user_post?count=15&coverFormat=2&cursor=0&post_item_list_request_type=0&secUid=MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-web-fetch_user_post" } }, "/apis/v1/tikhub/tiktok/web/fetch_user_profile": { "get": { "description": "TikTok (web).\n\n### Purpose:\n- Get user profile\n### Parameters:\n- secUid: User secUid\n- uniqueId: User uniqueId\n- At least one of secUid and uniqueId is provided, and uniqueId is preferred, that is, the username in the user's homepage link.\n### Return:\n- User profile\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_web_fetch_user_profile", "responses": { "200": { "description": "Successful Response\n\n### Return\n- User profile", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_user_profile", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "d75689bb927c" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/fetch_user_profile", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_web_fetch_user_profile", "method": "GET", "path": "/apis/v1/tikhub/tiktok/web/fetch_user_profile" }, "parameters": [ { "name": "secUid", "in": "query", "required": false, "schema": { "type": "string", "description": "User secUid", "default": "", "title": "Secuid" }, "description": "User secUid" }, { "name": "uniqueId", "in": "query", "required": false, "schema": { "type": "string", "description": "User uniqueId", "default": "", "title": "Uniqueid" }, "description": "User uniqueId", "example": "tiktok" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:a04545fe82ccf73d08275c50cc9f169547233c3576578c263d348aa4f2c450c2" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-web-fetch_user_profile" } }, "/apis/v1/tikhub/tiktok/web/fetch_user_repost": { "get": { "description": "TikTok (web).\n\n### Purpose\n- Get user reposts\n\n### Parameters\n- secUid: User secUid\n- cursor: Page cursor\n- count: Number per page, default is 20, cannot be changed.\n- coverFormat: Cover format, default is 2, optional values are 1 or 2.\n\n### Return\n- User reposts\n\n### Note\n- The direct video CDN links returned by this interface require the returned `tt_chain_token` to be accessed, otherwise HTTP 403 will be returned.\n- When accessing a direct video CDN link, carry `Cookie: tt_chain_token={tt_chain_token}` in the request header, where `{tt_chain_token}` is the value returned by this interface.\n- **If a direct video CDN link still returns HTTP 403**:\n 1. Use the video link starting with `https://www.tiktok.com/aweme/v1/play/` from the response instead (found in the `UrlList` fields under `video`)\n 2. Send that link **without any Cookie** - carrying `tt_chain_token` will cause HTTP 403\n- If you need watermark-free video links that require no Cookie at all, use /tikhub/tiktok/app/v3/fetch_one_video.\n\nAPI references: `fetch_one_video` = `GET /tikhub/tiktok/app/v3/fetch_one_video` (operationId: `get_tikhub_tiktok_app_v3_fetch_one_video`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_web_fetch_user_repost", "responses": { "200": { "description": "Successful Response\n\n### Return\n- User reposts", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok fetch_user_repost", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "c698191983d3" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/fetch_user_repost", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_web_fetch_user_repost", "method": "GET", "path": "/apis/v1/tikhub/tiktok/web/fetch_user_repost" }, "parameters": [ { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number per page, default is 20, cannot be changed.", "default": 20, "title": "Count" }, "description": "Number per page, default is 20, cannot be changed.", "example": 20 }, { "name": "coverFormat", "in": "query", "required": false, "schema": { "type": "integer", "description": "Cover format, default is 2, optional values are 1 or 2.", "default": 2, "title": "Coverformat" }, "description": "Cover format, default is 2, optional values are 1 or 2.", "example": 2 }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page cursor", "default": 0, "title": "Cursor" }, "description": "Page cursor", "example": 0 }, { "name": "secUid", "in": "query", "required": true, "schema": { "type": "string", "description": "User secUid", "title": "Secuid" }, "description": "User secUid", "example": "MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:a517a466b3c43a2ba0eef96ef00d517d0fcd7a58ff58345c22bf676ef3250753" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/web/fetch_user_repost?count=20&coverFormat=2&cursor=0&secUid=MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-web-fetch_user_repost" } }, "/apis/v1/tikhub/tiktok/web/generate_fingerprint": { "get": { "description": "TikTok (web).\n\n### Purpose:\n- Generate random browser fingerprint data for custom msToken request\n### Parameters:\n- browser_type: Specify browser type, options:\n - chrome_windows: Chrome + Windows\n - chrome_mac: Chrome + macOS\n - firefox_windows: Firefox + Windows\n - firefox_mac: Firefox + macOS\n - Leave empty for random selection\n### Return:\n- Browser fingerprint data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_web_generate_fingerprint", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Browser fingerprint data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok generate_fingerprint", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "8c16d3a27181" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/generate_fingerprint", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_web_generate_fingerprint", "method": "GET", "path": "/apis/v1/tikhub/tiktok/web/generate_fingerprint" }, "parameters": [ { "name": "browser_type", "in": "query", "required": false, "schema": { "type": "string", "title": "Browser Type" }, "description": "Specify browser type, options:\n - chrome_windows: Chrome + Windows\n - chrome_mac: Chrome + macOS\n - firefox_windows: Firefox + Windows\n - firefox_mac: Firefox + macOS\n - Leave empty for random selection" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:4aba0260d268c435ed4d508f1e0fa0f39281a8ef3d0796a17e1373865b842908" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-web-generate_fingerprint" } }, "/apis/v1/tikhub/tiktok/web/generate_hashed_id": { "get": { "description": "TikTok (web).\n\n### Purpose:\n- Generate hashed ID for TikTok Web\n### Parameters:\n- email: Email address\n### Return:\n- Generated hashed ID string\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_web_generate_hashed_id", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Generated hashed ID string", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok generate_hashed_id", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "1a9e4cc93bf7" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/generate_hashed_id", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_web_generate_hashed_id", "method": "GET", "path": "/apis/v1/tikhub/tiktok/web/generate_hashed_id" }, "parameters": [ { "name": "email", "in": "query", "required": true, "schema": { "type": "string", "description": "Email address", "title": "Email" }, "description": "Email address", "example": "test@example.com" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:3e9098e9f5b39391a950386a0253452fc51320244d8397f676d4ac5108010f7c" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/web/generate_hashed_id?email=test%40example.com' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-web-generate_hashed_id" } }, "/apis/v1/tikhub/tiktok/web/generate_real_msToken": { "get": { "description": "TikTok (web).\n\n### Purpose:\n- Generate real msToken\n### Parameters:\n- random_strData: Whether to use randomized browser fingerprint data (recommended for better anti-bot)\n- browser_type: Specify browser type, options:\n - chrome_windows: Chrome + Windows\n - chrome_mac: Chrome + macOS\n - firefox_windows: Firefox + Windows\n - firefox_mac: Firefox + macOS\n - Leave empty for random selection\n### Return:\n- Real msToken\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_web_generate_real_msToken", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Real msToken", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok generate_real_msToken", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "70ce33671b0e" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/generate_real_msToken", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_web_generate_real_msToken", "method": "GET", "path": "/apis/v1/tikhub/tiktok/web/generate_real_msToken" }, "parameters": [ { "name": "browser_type", "in": "query", "required": false, "schema": { "type": "string", "title": "Browser Type" }, "description": "Specify browser type, options:\n - chrome_windows: Chrome + Windows\n - chrome_mac: Chrome + macOS\n - firefox_windows: Firefox + Windows\n - firefox_mac: Firefox + macOS\n - Leave empty for random selection" }, { "name": "random_strData", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "title": "Random Strdata" }, "description": "Whether to use randomized browser fingerprint data (recommended for better anti-bot)" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:d1f2d7dfa660f3bab6be88f2db191e56a429791e2496e1b31df11c51501dcc8c" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-web-generate_real_msToken" } }, "/apis/v1/tikhub/tiktok/web/generate_ttwid": { "get": { "description": "TikTok (web).\n\n### Purpose:\n- Generate ttwid\n### Parameters:\n- None\n### Return:\n- ttwid\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_web_generate_ttwid", "responses": { "200": { "description": "Successful Response\n\n### Return\n- ttwid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok generate_ttwid", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "7cd2f670c189" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/generate_ttwid", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_web_generate_ttwid", "method": "GET", "path": "/apis/v1/tikhub/tiktok/web/generate_ttwid" }, "parameters": [ { "name": "user_agent", "in": "query", "required": false, "schema": { "type": "string", "default": "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:125.0) Gecko/20100101 Firefox/125.0", "title": "User Agent" }, "description": "User Agent" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:7f7b18196cef65139ee619c2b3111029ca5e8e25151b66baa9a244833e8c7d7c" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-web-generate_ttwid" } }, "/apis/v1/tikhub/tiktok/web/generate_webid": { "get": { "description": "TikTok (web).\n\n### Purpose:\n- Generate TikTok web_id (device_id in Web API request parameters)\n### Parameters:\n- cookie: Custom cookie (must contain odin_tt), uses default if not provided\n- user_agent: User agent string\n- url: Request source URL\n- referer: Referrer page\n- user_unique_id: User unique ID (optional)\n- app_id: Application ID, default 1988, represents TikTok Web app\n### Return:\n- web_id: Generated web_id\n- e: Error code (0 means success)\n- ssid: Session ID\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_web_generate_webid", "responses": { "200": { "description": "Successful Response\n\n### Return\n- web_id: Generated web_id\n- e: Error code (0 means success)\n- ssid: Session ID", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok generate_webid", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "9a0465a85e14" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/generate_webid", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_web_generate_webid", "method": "GET", "path": "/apis/v1/tikhub/tiktok/web/generate_webid" }, "parameters": [ { "name": "app_id", "in": "query", "required": false, "schema": { "type": "integer", "default": 1988, "title": "App Id" }, "description": "Application ID, default 1988, represents TikTok Web app" }, { "name": "cookie", "in": "query", "required": false, "schema": { "type": "string", "title": "Cookie" }, "description": "Custom cookie (must contain odin_tt), uses default if not provided" }, { "name": "referer", "in": "query", "required": false, "schema": { "type": "string", "default": "", "title": "Referer" }, "description": "Referrer page" }, { "name": "url", "in": "query", "required": false, "schema": { "type": "string", "default": "https://www.tiktok.com/explore", "title": "Url" }, "description": "Request source URL" }, { "name": "user_agent", "in": "query", "required": false, "schema": { "type": "string", "default": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:145.0) Gecko/20100101 Firefox/145.0", "title": "User Agent" }, "description": "User agent string" }, { "name": "user_unique_id", "in": "query", "required": false, "schema": { "type": "string", "default": "", "title": "User Unique Id" }, "description": "User unique ID (optional)" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:3365bf6807311c83745247d0281e190b8b39e5a290615a150b8cd5e5b3a4ff6c" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-web-generate_webid" } }, "/apis/v1/tikhub/tiktok/web/generate_wss_xb_signature": { "get": { "description": "TikTok (web).\n\n### Purpose:\n- Generate X-Bogus signature required for TikTok Live WSS connection\n### Parameters:\n- user_agent: User browser agent (optional, uses default UA if not provided)\n### Return:\n- x_bogus: WSS X-Bogus signature string\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_web_generate_wss_xb_signature", "responses": { "200": { "description": "Successful Response\n\n### Return\n- x_bogus: WSS X-Bogus signature string", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok generate_wss_xb_signature", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "faa7d5d2ded6" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/generate_wss_xb_signature", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_web_generate_wss_xb_signature", "method": "GET", "path": "/apis/v1/tikhub/tiktok/web/generate_wss_xb_signature" }, "parameters": [ { "name": "user_agent", "in": "query", "required": false, "schema": { "type": "string", "description": "User browser agent (optional, uses default UA if not provided)", "title": "User Agent" }, "description": "User browser agent (optional, uses default UA if not provided)", "example": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/143.0.0.0 Safari/537.36 Edg/143.0.0.0" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:2d0e0b19065301699c78f414a63dd6794044c7cf8b35d929c628efff23b06b7f" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-web-generate_wss_xb_signature" } }, "/apis/v1/tikhub/tiktok/web/generate_x_mssdk_info": { "post": { "description": "TikTok (web).\n\n### Purpose:\n- Generate X-Mssdk-Info and X-Mssdk-RC, used for TikTok Web device registration, login, and other scenarios\n### Parameters:\n- user_agent (str, optional): User-Agent string, currently not supported for customization, defaults to a fixed value\n### Return:\n- X-Mssdk-Info: Generated signing information\n- X-Mssdk-RC: Generated RC value\n- user_agent: The User-Agent string used\n- version: The webmssdk version used for signing\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_tiktok_web_generate_x_mssdk_info", "responses": { "200": { "description": "Successful Response\n\n### Return\n- X-Mssdk-Info: Generated signing information\n- X-Mssdk-RC: Generated RC value\n- user_agent: The User-Agent string used\n- version: The webmssdk version used for signing", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok generate_x_mssdk_info", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a31dd2289788" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/generate_x_mssdk_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_tiktok_web_generate_x_mssdk_info", "method": "POST", "path": "/apis/v1/tikhub/tiktok/web/generate_x_mssdk_info" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "user_agent": { "title": "User Agent", "description": "Optional User-Agent string, currently not supported for customization, defaults to a fixed value", "type": [ "string", "null" ] } }, "type": "object", "title": "XMssdkInfoModel" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:70fba84531359110ad24b569020639594a84ec63f63c6b70265e70d3383bcb54" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-tiktok-web-generate_x_mssdk_info" } }, "/apis/v1/tikhub/tiktok/web/generate_xbogus": { "post": { "description": "TikTok (web).\n\n### Purpose:\n- Generate xbogus\n### Parameters:\n- url: Unsigned API URL\n- user_agent: User browser User-Agent\n### Return:\n- xbogus\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_tiktok_web_generate_xbogus", "responses": { "200": { "description": "Successful Response\n\n### Return\n- xbogus", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok generate_xbogus", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "620aed16bfbf" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/generate_xbogus", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_tiktok_web_generate_xbogus", "method": "POST", "path": "/apis/v1/tikhub/tiktok/web/generate_xbogus" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "url": { "type": "string", "title": "Url", "description": "The requested API URL, no need to encode", "example": "https://www.douyin.com/aweme/v1/web/aweme/detail/?aweme_id=7148736076176215311&device_platform=webapp&aid=6383&channel=channel_pc_web&pc_client_type=1&version_code=170400&version_name=17.4.0&cookie_enabled=true&screen_width=1920&screen_height=1080&browser_language=zh-CN&browser_platform=Win32&browser_name=Edge&browser_version=117.0.2045.47&browser_online=true&engine_name=Blink&engine_version=117.0.0.0&os_name=Windows&os_version=10&cpu_core_num=128&device_memory=10240&platform=PC&downlink=10&effective_type=4g&round_trip_time=100" }, "user_agent": { "type": "string", "title": "User Agent", "description": "User-Agent when requesting the API", "example": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/90.0.4430.212 Safari/537.36" } }, "type": "object", "required": [ "url", "user_agent" ], "title": "XBogusModel" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:4e2e8aa43833e037b35730d7209f342aa7d15d94c028ad080302cd698ecf142a" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-tiktok-web-generate_xbogus" } }, "/apis/v1/tikhub/tiktok/web/generate_xgnarly": { "post": { "description": "TikTok (web).\n\n### Purpose:\n- Generate XGnarly encryption, used for TikTok Web API requests\n- This interface uses the latest version (V5.2.0, as of March 2026) signing service, User-Agent cannot be customized, a common browser User-Agent will be automatically generated\n- This interface perfectly restores the algorithm, ignores all risk controls except for verification codes\n### Parameters:\n- url (str): The requested API URL without signature (X-Bogus or X-Gnarly) and including the domain name, no need to URL encode\n- body (str): The API parameters of the request, applicable for POST requests, not required for GET requests\n### Return:\n- X-Gnarly encryption string + User-Agent of a random browser\n\n\nPublished reference price: $0.002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_tiktok_web_generate_xgnarly", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- X-Gnarly encryption string + User-Agent of a random browser", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok generate_xgnarly", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "4805eaba9df1" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/generate_xgnarly", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_tiktok_web_generate_xgnarly", "method": "POST", "path": "/apis/v1/tikhub/tiktok/web/generate_xgnarly" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "url": { "type": "string", "title": "Url", "description": "The requested API URL including domain and parameters, no need to URL encode", "example": "https://www.tiktok.com/api/search/user/full/?WebIdLastTime=1756087650&aid=1988&app_language=zh-Hans&app_name=tiktok_web&browser_language=zh-CN&browser_name=Mozilla&browser_online=true&browser_platform=MacIntel&browser_version=5.0%20%28Macintosh%3B%20Intel%20Mac%20OS%20X%2010_15_7%29%20AppleWebKit%2F537.36%20%28KHTML%2C%20like%20Gecko%29%20Chrome%2F139.0.0.0%20Safari%2F537.36&channel=tiktok_web&cookie_enabled=true&cursor=10&data_collection_enabled=false&device_id=7542339104672111234&device_platform=web_pc&focus_state=true&from_page=search&history_len=3&is_fullscreen=true&is_page_visible=true&keyword=musk&odinId=7542338997269211234&os=mac&priority_region&referer®ion=US&screen_height=967&screen_width=1496&search_id&tz_name=America%2FLos_Angeles&user_is_login=false&web_search_code=%7B%22tiktok%22%3A%7B%22client_params_x%22%3A%7B%22search_engine%22%3A%7B%22ies_mt_user_live_video_card_use_libra%22%3A1%2C%22mt_search_general_user_live_card%22%3A1%7D%7D%2C%22search_server%22%3A%7B%7D%7D%7D&webcast_language=zh-Hans" }, "body": { "title": "Body", "description": "The API parameters of the request, applicable for POST requests", "default": "", "type": [ "string", "null" ] } }, "type": "object", "required": [ "url" ], "title": "XGnarlyAndXBogusModel" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:6ace9d7a0f7cbfbde783643a05ef3587bc638e4dfa362f71049d3f2a12255f8a" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/tiktok/web/generate_xgnarly \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"url\": \"https://www.tiktok.com/api/search/user/full/?WebIdLastTime=1756087650&aid=1988&app_language=zh-Hans&app_name=tiktok_web&browser_language=zh-CN&browser_name=Mozilla&browser_online=true&browser_platform=MacIntel&browser_version=5.0%20%28Macintosh%3B%20Intel%20Mac%20OS%20X%2010_15_7%29%20AppleWebKit%2F537.36%20%28KHTML%2C%20like%20Gecko%29%20Chrome%2F139.0.0.0%20Safari%2F537.36&channel=tiktok_web&cookie_enabled=true&cursor=10&data_collection_enabled=false&device_id=7542339104672111234&device_platform=web_pc&focus_state=true&from_page=search&history_len=3&is_fullscreen=true&is_page_visible=true&keyword=musk&odinId=7542338997269211234&os=mac&priority_region&referer®ion=US&screen_height=967&screen_width=1496&search_id&tz_name=America%2FLos_Angeles&user_is_login=false&web_search_code=%7B%22tiktok%22%3A%7B%22client_params_x%22%3A%7B%22search_engine%22%3A%7B%22ies_mt_user_live_video_card_use_libra%22%3A1%2C%22mt_search_general_user_live_card%22%3A1%7D%7D%2C%22search_server%22%3A%7B%7D%7D%7D&webcast_language=zh-Hans\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-tiktok-web-generate_xgnarly" } }, "/apis/v1/tikhub/tiktok/web/generate_xgnarly_and_xbogus": { "post": { "description": "TikTok (web). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Generate XGnarly and XBogus encryption, used for TikTok Web API requests\n- This interface can generate the latest version of encryption parameters X-Bogus and X-Gnarly, User-Agent cannot be customized, a common browser User-Agent will be automatically generated\n\n- The X-Bogus and X-Gnarly generated by this interface are the latest versions (V5.2.0, as of March 2026)\n\n### Parameters\n- url (str): The requested API URL without signature (X-Bogus or X-Gnarly) and including the domain name, no need to URL encode\n- body (str): The API parameters of the request, applicable for POST requests, not required for GET requests\n\n### Return\n- The latest version of X-Gnarly encryption + the latest version of X-Bogus encryption + User-Agent of a random browser\n\n\nPublished reference price: $0.005 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_tiktok_web_generate_xgnarly_and_xbogus", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- The latest version of X-Gnarly encryption + the latest version of X-Bogus encryption + User-Agent of a random browser", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok generate_xgnarly_and_xbogus", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.005, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "16dc6ea83e6f" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/generate_xgnarly_and_xbogus", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_tiktok_web_generate_xgnarly_and_xbogus", "method": "POST", "path": "/apis/v1/tikhub/tiktok/web/generate_xgnarly_and_xbogus" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "url": { "type": "string", "title": "Url", "description": "The requested API URL including domain and parameters, no need to URL encode", "example": "https://www.tiktok.com/api/search/user/full/?WebIdLastTime=1756087650&aid=1988&app_language=zh-Hans&app_name=tiktok_web&browser_language=zh-CN&browser_name=Mozilla&browser_online=true&browser_platform=MacIntel&browser_version=5.0%20%28Macintosh%3B%20Intel%20Mac%20OS%20X%2010_15_7%29%20AppleWebKit%2F537.36%20%28KHTML%2C%20like%20Gecko%29%20Chrome%2F139.0.0.0%20Safari%2F537.36&channel=tiktok_web&cookie_enabled=true&cursor=10&data_collection_enabled=false&device_id=7542339104672111234&device_platform=web_pc&focus_state=true&from_page=search&history_len=3&is_fullscreen=true&is_page_visible=true&keyword=musk&odinId=7542338997269211234&os=mac&priority_region&referer®ion=US&screen_height=967&screen_width=1496&search_id&tz_name=America%2FLos_Angeles&user_is_login=false&web_search_code=%7B%22tiktok%22%3A%7B%22client_params_x%22%3A%7B%22search_engine%22%3A%7B%22ies_mt_user_live_video_card_use_libra%22%3A1%2C%22mt_search_general_user_live_card%22%3A1%7D%7D%2C%22search_server%22%3A%7B%7D%7D%7D&webcast_language=zh-Hans" }, "body": { "title": "Body", "description": "The API parameters of the request, applicable for POST requests", "default": "", "type": [ "string", "null" ] } }, "type": "object", "required": [ "url" ], "title": "XGnarlyAndXBogusModel" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:0f97cab5b8393efa3afd4758db66834cbb1c4818e1b32b674f2799349bf357fe" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/tiktok/web/generate_xgnarly_and_xbogus \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"url\": \"https://www.tiktok.com/api/search/user/full/?WebIdLastTime=1756087650&aid=1988&app_language=zh-Hans&app_name=tiktok_web&browser_language=zh-CN&browser_name=Mozilla&browser_online=true&browser_platform=MacIntel&browser_version=5.0%20%28Macintosh%3B%20Intel%20Mac%20OS%20X%2010_15_7%29%20AppleWebKit%2F537.36%20%28KHTML%2C%20like%20Gecko%29%20Chrome%2F139.0.0.0%20Safari%2F537.36&channel=tiktok_web&cookie_enabled=true&cursor=10&data_collection_enabled=false&device_id=7542339104672111234&device_platform=web_pc&focus_state=true&from_page=search&history_len=3&is_fullscreen=true&is_page_visible=true&keyword=musk&odinId=7542338997269211234&os=mac&priority_region&referer®ion=US&screen_height=967&screen_width=1496&search_id&tz_name=America%2FLos_Angeles&user_is_login=false&web_search_code=%7B%22tiktok%22%3A%7B%22client_params_x%22%3A%7B%22search_engine%22%3A%7B%22ies_mt_user_live_video_card_use_libra%22%3A1%2C%22mt_search_general_user_live_card%22%3A1%7D%7D%2C%22search_server%22%3A%7B%7D%7D%7D&webcast_language=zh-Hans\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-tiktok-web-generate_xgnarly_and_xbogus" } }, "/apis/v1/tikhub/tiktok/web/get_all_aweme_id": { "post": { "description": "TikTok (web).\n\n### Purpose\n- Extract list video id\n\n### Parameters\n- Root JSON body: Video link (Support up to 20 links)\n\n### Return\n- Video id\n\n### Request body\nSend the request body as a JSON array of strings at the root.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_tiktok_web_get_all_aweme_id", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Video id", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok get_all_aweme_id", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "4b8fb65ea97d" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/get_all_aweme_id", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_tiktok_web_get_all_aweme_id", "method": "POST", "path": "/apis/v1/tikhub/tiktok/web/get_all_aweme_id" }, "requestBody": { "content": { "application/json": { "schema": { "items": { "type": "string" }, "type": "array", "title": "Url", "description": "Video link Send the request body as a JSON array of strings at the root." }, "example": [ "https://www.tiktok.com/@owlcitymusic/video/7218694761253735723" ] } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:19ddf2a5c20ca7e1601bac6858e0aed1c9abce29efdcd306b8d2d2cdf8799122" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/tiktok/web/get_all_aweme_id \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '[\n \"https://www.tiktok.com/@owlcitymusic/video/7218694761253735723\"\n]'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-tiktok-web-get_all_aweme_id" } }, "/apis/v1/tikhub/tiktok/web/get_all_sec_user_id": { "post": { "description": "TikTok (web).\n\n### Purpose\n- Extract list user id\n\n### Parameters\n- Root JSON body: User homepage link (Support up to 10 links)\n\n### Return\n- If the sec_user_id is successfully obtained, the sec_user_id is returned, otherwise the original input link is returned, and the reason why the sec_user_id cannot be obtained can be manually verified later.\n\n### Request body\nSend the request body as a JSON array of strings at the root.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_tiktok_web_get_all_sec_user_id", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- If the sec_user_id is successfully obtained, the sec_user_id is returned, otherwise the original input link is returned, and the reason why the sec_user_id cannot be obtained can be manually verified later.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok get_all_sec_user_id", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "3a1ed3b3dfbc" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/get_all_sec_user_id", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_tiktok_web_get_all_sec_user_id", "method": "POST", "path": "/apis/v1/tikhub/tiktok/web/get_all_sec_user_id" }, "requestBody": { "content": { "application/json": { "schema": { "items": { "type": "string" }, "type": "array", "title": "Url", "description": "User homepage link Send the request body as a JSON array of strings at the root." }, "example": [ "https://www.tiktok.com/@tiktok" ] } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:85507ad1a35613ae10474dadc3f7d51426659aaa5eabe7f76a0cb58eeab47101" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/tiktok/web/get_all_sec_user_id \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '[\n \"https://www.tiktok.com/@tiktok\"\n]'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-tiktok-web-get_all_sec_user_id" } }, "/apis/v1/tikhub/tiktok/web/get_all_unique_id": { "post": { "description": "TikTok (web).\n\n### Purpose\n- Get list unique_id\n\n### Parameters\n- Root JSON body: User homepage link (Support up to 20 links)\n\n### Return\n- unique_id\n\n### Request body\nSend the request body as a JSON array of strings at the root.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_tiktok_web_get_all_unique_id", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- unique_id", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok get_all_unique_id", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "d978a61a22d2" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/get_all_unique_id", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_tiktok_web_get_all_unique_id", "method": "POST", "path": "/apis/v1/tikhub/tiktok/web/get_all_unique_id" }, "requestBody": { "content": { "application/json": { "schema": { "items": { "type": "string" }, "type": "array", "title": "Url", "description": "User homepage link Send the request body as a JSON array of strings at the root." }, "example": [ "https://www.tiktok.com/@tiktok" ] } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:866f899f167c019ee06706c9c7b377f37f32b9934aafb87ae70de59df6f907c5" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/tiktok/web/get_all_unique_id \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '[\n \"https://www.tiktok.com/@tiktok\"\n]'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-tiktok-web-get_all_unique_id" } }, "/apis/v1/tikhub/tiktok/web/get_aweme_id": { "get": { "description": "TikTok (web).\n\n### Purpose:\n- Extract single video id\n### Parameters:\n- url: Video link\n### Return:\n- Video id\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_web_get_aweme_id", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Video id", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok get_aweme_id", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "0992dbc1baa4" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/get_aweme_id", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_web_get_aweme_id", "method": "GET", "path": "/apis/v1/tikhub/tiktok/web/get_aweme_id" }, "parameters": [ { "name": "url", "in": "query", "required": true, "schema": { "type": "string", "description": "Video link", "title": "Url" }, "description": "Video link", "example": "https://www.tiktok.com/@owlcitymusic/video/7218694761253735723" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:60f4b7d549fdf2cd57ceb4cb3aa50b9239a24613822c7e53c2dbcb61b88e87ac" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/web/get_aweme_id?url=https%3A%2F%2Fwww.tiktok.com%2F%40owlcitymusic%2Fvideo%2F7218694761253735723' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-web-get_aweme_id" } }, "/apis/v1/tikhub/tiktok/web/get_live_room_id": { "get": { "description": "TikTok (web).\n\n### Purpose:\n- Extract live room Room ID from live room link\n- Support short links, such as: https://vt.tiktok.com/ZSjuyJnWQ/\n- Support long links, such as: https://www.tiktok.com/@maksukaracun/live\n### Parameters:\n- live_room_url: Live room link\n### Return:\n- Live room Room ID\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_web_get_live_room_id", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Live room Room ID", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok get_live_room_id", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "f314daed8a47" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/get_live_room_id", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_web_get_live_room_id", "method": "GET", "path": "/apis/v1/tikhub/tiktok/web/get_live_room_id" }, "parameters": [ { "name": "live_room_url", "in": "query", "required": true, "schema": { "type": "string", "description": "Live room link", "title": "Live Room Url" }, "description": "Live room link", "example": "https://www.tiktok.com/@maksukaracun/live" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:1c249c7328b00998c69f49f5c8652e4f39d291d50b0a3a8f6c31a5a4109ca91a" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/web/get_live_room_id?live_room_url=https%3A%2F%2Fwww.tiktok.com%2F%40maksukaracun%2Flive' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-web-get_live_room_id" } }, "/apis/v1/tikhub/tiktok/web/get_sec_user_id": { "get": { "description": "TikTok (web).\n\n### Purpose:\n- Extract list user id\n### Parameters:\n- url: User homepage link\n### Return:\n- User id\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_web_get_sec_user_id", "responses": { "200": { "description": "Successful Response\n\n### Return\n- User id", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok get_sec_user_id", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "d3c58784585e" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/get_sec_user_id", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_web_get_sec_user_id", "method": "GET", "path": "/apis/v1/tikhub/tiktok/web/get_sec_user_id" }, "parameters": [ { "name": "url", "in": "query", "required": true, "schema": { "type": "string", "description": "User homepage link", "title": "Url" }, "description": "User homepage link", "example": "https://www.tiktok.com/@tiktok" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:220c380dc8180a87d32c444ab292ef0d6198b025d4f86e109e04c3947a540e4f" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/web/get_sec_user_id?url=https%3A%2F%2Fwww.tiktok.com%2F%40tiktok' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-web-get_sec_user_id" } }, "/apis/v1/tikhub/tiktok/web/get_unique_id": { "get": { "description": "TikTok (web).\n\n### Purpose:\n- Get user unique_id\n### Parameters:\n- url: User homepage link\n### Return:\n- unique_id\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_web_get_unique_id", "responses": { "200": { "description": "Successful Response\n\n### Return\n- unique_id", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok get_unique_id", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "3e1c236ce53f" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/get_unique_id", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_web_get_unique_id", "method": "GET", "path": "/apis/v1/tikhub/tiktok/web/get_unique_id" }, "parameters": [ { "name": "url", "in": "query", "required": true, "schema": { "type": "string", "description": "User homepage link", "title": "Url" }, "description": "User homepage link", "example": "https://www.tiktok.com/@tiktok" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:9d7541b45aa0ca09a9288b849a1851c3e064e3716be3555fda0050a2a5ffee90" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/web/get_unique_id?url=https%3A%2F%2Fwww.tiktok.com%2F%40tiktok' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-web-get_unique_id" } }, "/apis/v1/tikhub/tiktok/web/get_user_id": { "get": { "description": "TikTok (web).\n\n### Purpose:\n- Extract list user id\n### Parameters:\n- url: User homepage link\n### Return:\n- User id\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_web_get_user_id", "responses": { "200": { "description": "Successful Response\n\n### Return\n- User id", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok get_user_id", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "cdc43dfc8549" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/get_user_id", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_web_get_user_id", "method": "GET", "path": "/apis/v1/tikhub/tiktok/web/get_user_id" }, "parameters": [ { "name": "url", "in": "query", "required": true, "schema": { "type": "string", "description": "User homepage link", "title": "Url" }, "description": "User homepage link", "example": "https://www.tiktok.com/@tiktok" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:220c380dc8180a87d32c444ab292ef0d6198b025d4f86e109e04c3947a540e4f" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/web/get_user_id?url=https%3A%2F%2Fwww.tiktok.com%2F%40tiktok' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-web-get_user_id" } }, "/apis/v1/tikhub/tiktok/web/tiktok_live_room": { "get": { "description": "TikTok (web). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Extract live room danmaku\n- This interface is no longer available online, you need to purchase the source code and deploy it locally for use. To purchase the source code, please contact the administrator in the Discord server. Discord invite link: https://discord.gg/aMEAS8Xsvz\n#### Price:\n\n### Parameters\n- live_room_url: Live room link\n- danmaku_type: Message type\n - WebcastChatMessage: Chat message\n - WebcastMemberMessage: Member message\n - WebcastRoomUserSeqMessage: User sequence message\n - WebcastGiftMessage: Gift message\n - WebcastSocialMessage: Social message\n - WebcastLikeMessage: Like message\n - WebcastLinkMicFanTicketMethod: Link Mic Fan Ticket Method\n - WebcastLinkMicMethod: Link Mic Method\n\n### Return\n- WebSocket connection information of the danmaku data, you need to use WebSocket connection to get the danmaku data, this interface does not return the danmaku data.\n\n\nPublished reference price: $0.0001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_tiktok_web_tiktok_live_room", "responses": { "200": { "description": "Successful Response\n\n### Return\n- WebSocket connection information of the danmaku data, you need to use WebSocket connection to get the danmaku data, this interface does not return the danmaku data.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "tiktok tiktok_live_room", "tags": [ "tikhub.tiktok" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.0001, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "76c3ba977c11" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tiktok/web/tiktok_live_room", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_tiktok_web_tiktok_live_room", "method": "GET", "path": "/apis/v1/tikhub/tiktok/web/tiktok_live_room" }, "parameters": [ { "name": "danmaku_type", "in": "query", "required": true, "schema": { "type": "string", "description": "Message type\n - WebcastChatMessage: Chat message\n - WebcastMemberMessage: Member message\n - WebcastRoomUserSeqMessage: User sequence message\n - WebcastGiftMessage: Gift message\n - WebcastSocialMessage: Social message\n - WebcastLikeMessage: Like message\n - WebcastLinkMicFanTicketMethod: Link Mic Fan Ticket Method\n - WebcastLinkMicMethod: Link Mic Method", "title": "Danmaku Type" }, "description": "Message type\n - WebcastChatMessage: Chat message\n - WebcastMemberMessage: Member message\n - WebcastRoomUserSeqMessage: User sequence message\n - WebcastGiftMessage: Gift message\n - WebcastSocialMessage: Social message\n - WebcastLikeMessage: Like message\n - WebcastLinkMicFanTicketMethod: Link Mic Fan Ticket Method\n - WebcastLinkMicMethod: Link Mic Method", "example": "WebcastChatMessage" }, { "name": "live_room_url", "in": "query", "required": true, "schema": { "type": "string", "description": "Live room link", "title": "Live Room Url" }, "description": "Live room link", "example": "https://www.tiktok.com/@mpl.id.official/live" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:6537ac4c6103e4de9f070f441a1b91da5c6237defa1b136ad09a7db8d9c06606" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/tiktok/web/tiktok_live_room?danmaku_type=WebcastChatMessage&live_room_url=https%3A%2F%2Fwww.tiktok.com%2F%40mpl.id.official%2Flive' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-tiktok-web-tiktok_live_room" } }, "/apis/v1/tikhub/toutiao/app/get_article_info": { "get": { "description": "Toutiao (app).\n\n### Purpose:\n- Get information of specified post\n### Parameters:\n- group_id: Post ID, can be obtained from the link\n - For example: https://www.toutiao.com/article/7450114952884503059/\n### Return:\n- Post information\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_toutiao_app_get_article_info", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Post information", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "toutiao get_article_info", "tags": [ "tikhub.toutiao" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "95c5ccde9696" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/toutiao/app/get_article_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_toutiao_app_get_article_info", "method": "GET", "path": "/apis/v1/tikhub/toutiao/app/get_article_info" }, "parameters": [ { "name": "group_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Post ID, can be obtained from the link\n - For example: https://www.toutiao.com/article/7450114952884503059/", "title": "Group Id" }, "description": "Post ID, can be obtained from the link\n - For example: https://www.toutiao.com/article/7450114952884503059/", "example": "7450114952884503059" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:763354e9ee3d397ec2028941837018d6ea8590d0d6df4c28b0dc0171a536fa0b" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/toutiao/app/get_article_info?group_id=7450114952884503059' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-toutiao-app-get_article_info" } }, "/apis/v1/tikhub/toutiao/app/get_comments": { "get": { "description": "Toutiao (app).\n\n### Purpose:\n- Get comments of specified post\n### Parameters:\n- group_id: Post ID, can be obtained from the link\n - For example: https://www.toutiao.com/i7453372680222523931/\n- offset: Offset, used for pagination, default is 0, then add 20 each time\n### Return:\n- Comment list\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_toutiao_app_get_comments", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Comment list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "toutiao get_comments", "tags": [ "tikhub.toutiao" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "2d85b49f6cc4" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/toutiao/app/get_comments", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_toutiao_app_get_comments", "method": "GET", "path": "/apis/v1/tikhub/toutiao/app/get_comments" }, "parameters": [ { "name": "group_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Post ID, can be obtained from the link\n - For example: https://www.toutiao.com/i7453372680222523931/", "title": "Group Id" }, "description": "Post ID, can be obtained from the link\n - For example: https://www.toutiao.com/i7453372680222523931/", "example": "7453372680222523931" }, { "name": "offset", "in": "query", "required": true, "schema": { "type": "string", "description": "Offset, used for pagination, default is 0, then add 20 each time", "title": "Offset" }, "description": "Offset, used for pagination, default is 0, then add 20 each time", "example": "0" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:962042ab31520ad47812c75e1610f6b2607494f0d51602f751aa63bf046f5eff" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/toutiao/app/get_comments?group_id=7453372680222523931&offset=0' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-toutiao-app-get_comments" } }, "/apis/v1/tikhub/toutiao/app/get_user_id": { "get": { "description": "Toutiao (app).\n\n### Purpose:\n- Get user_id from user profile\n### Parameters:\n- user_profile_url: User profile URL\n - For example: https://www.toutiao.com/c/user/token/MS4wLjABAAAAwK6echNksY69R8l2vcZudupfhTItbGSGt-8ineO5UaB4L-djqkYDgB6TkAdMvrmW/\n### Return:\n- User ID\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_toutiao_app_get_user_id", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- User ID", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "toutiao get_user_id", "tags": [ "tikhub.toutiao" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "8e62875a44a8" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/toutiao/app/get_user_id", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_toutiao_app_get_user_id", "method": "GET", "path": "/apis/v1/tikhub/toutiao/app/get_user_id" }, "parameters": [ { "name": "user_profile_url", "in": "query", "required": true, "schema": { "type": "string", "description": "User profile URL\n - For example: https://www.toutiao.com/c/user/token/MS4wLjABAAAAwK6echNksY69R8l2vcZudupfhTItbGSGt-8ineO5UaB4L-djqkYDgB6TkAdMvrmW/", "title": "User Profile Url" }, "description": "User profile URL\n - For example: https://www.toutiao.com/c/user/token/MS4wLjABAAAAwK6echNksY69R8l2vcZudupfhTItbGSGt-8ineO5UaB4L-djqkYDgB6TkAdMvrmW/", "example": "https://www.toutiao.com/c/user/token/MS4wLjABAAAAwK6echNksY69R8l2vcZudupfhTItbGSGt-8ineO5UaB4L-djqkYDgB6TkAdMvrmW/" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:d08b9bcf6e815f311516a942132cc37936203c0c903aaf8ba85e81d748d1b06f" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/toutiao/app/get_user_id?user_profile_url=https%3A%2F%2Fwww.toutiao.com%2Fc%2Fuser%2Ftoken%2FMS4wLjABAAAAwK6echNksY69R8l2vcZudupfhTItbGSGt-8ineO5UaB4L-djqkYDgB6TkAdMvrmW%2F' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-toutiao-app-get_user_id" } }, "/apis/v1/tikhub/toutiao/app/get_user_info": { "get": { "description": "Toutiao (app).\n\n### Purpose\n- Get information of specified user\n\n### Parameters\n- user_id: User ID, can be obtained from the following API:\n - `/tikhub/toutiao/app/get_user_id`\n\n### Return\n- User information\n\nAPI references: `get_user_id` = `GET /tikhub/toutiao/app/get_user_id` (operationId: `get_tikhub_toutiao_app_get_user_id`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_toutiao_app_get_user_info", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- User information", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "toutiao get_user_info", "tags": [ "tikhub.toutiao" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "14343308481d" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/toutiao/app/get_user_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_toutiao_app_get_user_info", "method": "GET", "path": "/apis/v1/tikhub/toutiao/app/get_user_info" }, "parameters": [ { "name": "user_id", "in": "query", "required": true, "schema": { "type": "string", "description": "User ID, can be obtained from the following API:\n - `/tikhub/toutiao/app/get_user_id`\n\nAPI references: `get_user_id` = `GET /tikhub/toutiao/app/get_user_id` (operationId: `get_tikhub_toutiao_app_get_user_id`).", "title": "User Id" }, "description": "User ID, can be obtained from the following API:\n - `/tikhub/toutiao/app/get_user_id`\n\nAPI references: `get_user_id` = `GET /tikhub/toutiao/app/get_user_id` (operationId: `get_tikhub_toutiao_app_get_user_id`).", "example": "1352838578180211" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:341539e411b93db6baa5bed99c92d549d02d8e735420963c120d407a371ff36a" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/toutiao/app/get_user_info?user_id=1352838578180211' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-toutiao-app-get_user_info" } }, "/apis/v1/tikhub/toutiao/app/get_video_info": { "get": { "description": "Toutiao (app).\n\n### Purpose:\n- Get information of specified video\n### Parameters:\n- group_id: Post ID, can be obtained from the link\n - For example: https://www.toutiao.com/video/7431543350882206242/\n### Return:\n- Post information\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_toutiao_app_get_video_info", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Post information", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "toutiao get_video_info", "tags": [ "tikhub.toutiao" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "4e958f7cb741" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/toutiao/app/get_video_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_toutiao_app_get_video_info", "method": "GET", "path": "/apis/v1/tikhub/toutiao/app/get_video_info" }, "parameters": [ { "name": "group_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Post ID, can be obtained from the link\n - For example: https://www.toutiao.com/video/7431543350882206242/", "title": "Group Id" }, "description": "Post ID, can be obtained from the link\n - For example: https://www.toutiao.com/video/7431543350882206242/", "example": "7431543350882206242" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:763354e9ee3d397ec2028941837018d6ea8590d0d6df4c28b0dc0171a536fa0b" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/toutiao/app/get_video_info?group_id=7431543350882206242' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-toutiao-app-get_video_info" } }, "/apis/v1/tikhub/toutiao/web/get_article_info": { "get": { "description": "Toutiao (web).\n\n### Purpose:\n- Get information of specified post\n### Parameters:\n- aweme_id: Post ID, can be obtained from the link\n - For example: https://www.toutiao.com/article/7450114952884503059/\n### Return:\n- Post information\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_toutiao_web_get_article_info", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Post information", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "toutiao get_article_info", "tags": [ "tikhub.toutiao" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a1706a3f5a99" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/toutiao/web/get_article_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_toutiao_web_get_article_info", "method": "GET", "path": "/apis/v1/tikhub/toutiao/web/get_article_info" }, "parameters": [ { "name": "aweme_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Post ID, can be obtained from the link\n - For example: https://www.toutiao.com/article/7450114952884503059/", "title": "Aweme Id" }, "description": "Post ID, can be obtained from the link\n - For example: https://www.toutiao.com/article/7450114952884503059/", "example": "7450114952884503059" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:763354e9ee3d397ec2028941837018d6ea8590d0d6df4c28b0dc0171a536fa0b" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/toutiao/web/get_article_info?aweme_id=7450114952884503059' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-toutiao-web-get_article_info" } }, "/apis/v1/tikhub/toutiao/web/get_video_info": { "get": { "description": "Toutiao (web).\n\n### Purpose:\n- Get information of specified video\n### Parameters:\n- aweme_id: Post ID, can be obtained from the link\n - For example: https://www.toutiao.com/video/7431543350882206242/\n### Return:\n- Post information\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_toutiao_web_get_video_info", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Post information", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "toutiao get_video_info", "tags": [ "tikhub.toutiao" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "df122416d91b" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/toutiao/web/get_video_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_toutiao_web_get_video_info", "method": "GET", "path": "/apis/v1/tikhub/toutiao/web/get_video_info" }, "parameters": [ { "name": "aweme_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Post ID, can be obtained from the link\n - For example: https://www.toutiao.com/video/7431543350882206242/", "title": "Aweme Id" }, "description": "Post ID, can be obtained from the link\n - For example: https://www.toutiao.com/video/7431543350882206242/", "example": "7431543350882206242" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:763354e9ee3d397ec2028941837018d6ea8590d0d6df4c28b0dc0171a536fa0b" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/toutiao/web/get_video_info?aweme_id=7431543350882206242' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-toutiao-web-get_video_info" } }, "/apis/v1/tikhub/twitter/web/fetch_check_follow": { "get": { "description": "Twitter / X (web).\n\n### Purpose:\n- Check follow\n### Parameters:\n- user_name: Source screen name, for example: elonmusk\n- follows: Target screen name, for example: NASA\n### Return:\n- Follow relationship result\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_twitter_web_fetch_check_follow", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Follow relationship result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "twitter fetch_check_follow", "tags": [ "tikhub.twitter" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "1c0d481b9dc7" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/twitter/web/fetch_check_follow", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_twitter_web_fetch_check_follow", "method": "GET", "path": "/apis/v1/tikhub/twitter/web/fetch_check_follow" }, "parameters": [ { "name": "follows", "in": "query", "required": true, "schema": { "type": "string", "description": "Target Screen Name", "title": "Follows" }, "description": "Target Screen Name", "example": "NASA" }, { "name": "user_name", "in": "query", "required": true, "schema": { "type": "string", "description": "Source Screen Name", "title": "User Name" }, "description": "Source Screen Name", "example": "elonmusk" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:10ac28beabb9039312dff3ee9a1429027162fc8e10633fe8817e0b30d50c6037" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/twitter/web/fetch_check_follow?follows=NASA&user_name=elonmusk' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-twitter-web-fetch_check_follow" } }, "/apis/v1/tikhub/twitter/web/fetch_check_retweet": { "get": { "description": "Twitter / X (web).\n\n### Purpose:\n- Check retweet\n### Parameters:\n- screen_name: Screen name, for example: elonmusk\n- tweet_id: Tweet ID, for example: 1808168603721650364\n### Return:\n- Retweet relationship result\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_twitter_web_fetch_check_retweet", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Retweet relationship result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "twitter fetch_check_retweet", "tags": [ "tikhub.twitter" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "4a16cea5af52" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/twitter/web/fetch_check_retweet", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_twitter_web_fetch_check_retweet", "method": "GET", "path": "/apis/v1/tikhub/twitter/web/fetch_check_retweet" }, "parameters": [ { "name": "screen_name", "in": "query", "required": true, "schema": { "type": "string", "description": "Screen Name", "title": "Screen Name" }, "description": "Screen Name", "example": "elonmusk" }, { "name": "tweet_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Tweet ID, for example: 1808168603721650364", "title": "Tweet Id" }, "description": "Tweet ID, for example: 1808168603721650364", "example": "1808168603721650364" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:0a07c926d3aa6402c2a27763f148b48e090900f60ebb2d24cf5e3f1377659b49" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/twitter/web/fetch_check_retweet?screen_name=elonmusk&tweet_id=1808168603721650364' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-twitter-web-fetch_check_retweet" } }, "/apis/v1/tikhub/twitter/web/fetch_community_info": { "get": { "description": "Twitter / X (web).\n\n### Purpose:\n- Get community info\n### Parameters:\n- community_id: Community ID, for example: 1493290339532222469\n### Return:\n- Community info, including name, description, member count, primary topic and rules\n\n### Note:\n- The `status` field in the upstream response is the community join status (always `failed` in practice).\n It is unrelated to whether the request succeeded — do not use it to determine success.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_twitter_web_fetch_community_info", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Community info, including name, description, member count, primary topic and rules", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "twitter fetch_community_info", "tags": [ "tikhub.twitter" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "02b9d157019f" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/twitter/web/fetch_community_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_twitter_web_fetch_community_info", "method": "GET", "path": "/apis/v1/tikhub/twitter/web/fetch_community_info" }, "parameters": [ { "name": "community_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Community ID, for example: 1493290339532222469", "title": "Community Id" }, "description": "Community ID, for example: 1493290339532222469", "example": "1493290339532222469" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e924d7817ad9d0f0cb6fcdb6682cafedfac9f4e7800734c7e77d1dc2084b0e4e" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/twitter/web/fetch_community_info?community_id=1493290339532222469' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-twitter-web-fetch_community_info" } }, "/apis/v1/tikhub/twitter/web/fetch_community_members": { "get": { "description": "Twitter / X (web).\n\n### Purpose:\n- Get community members\n\n### ⚠️ No pagination\n- A single call returns only the first page (~19 members). There is no way to fetch more.\n- Upstream does return a `next_cursor` in the response, but passing that cursor back yields an\n empty list (verified across communities of different sizes — the behaviour is consistent).\n- The `cursor` parameter is kept only for forward compatibility if upstream fixes this. It currently\n has no effect — do not rely on it.\n- If you need a complete member list, this endpoint cannot provide it.\n\n### Parameters:\n- community_id: Community ID, for example: 1493290339532222469\n- cursor: Cursor, default is None. No pagination supported; passing it has no effect\n### Return:\n- Community member list (first page only, ~19 members)\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_twitter_web_fetch_community_members", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Community member list (first page only, ~19 members)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "twitter fetch_community_members", "tags": [ "tikhub.twitter" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "aa987a8756a6" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/twitter/web/fetch_community_members", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_twitter_web_fetch_community_members", "method": "GET", "path": "/apis/v1/tikhub/twitter/web/fetch_community_members" }, "parameters": [ { "name": "community_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Community ID, for example: 1493290339532222469", "title": "Community Id" }, "description": "Community ID, for example: 1493290339532222469", "example": "1493290339532222469" }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "description": "Cursor, default is None. No pagination supported; passing it has no effect", "title": "Cursor" }, "description": "Cursor, default is None. No pagination supported; passing it has no effect" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:63e1fa3ad2070e14e90e81ec3e2b97ec42eccf6f5721e8c2bfce6ef30a0cbf4d" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/twitter/web/fetch_community_members?community_id=1493290339532222469' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-twitter-web-fetch_community_members" } }, "/apis/v1/tikhub/twitter/web/fetch_community_timeline": { "get": { "description": "Twitter / X (web).\n\n### Purpose:\n- Get community timeline\n### Parameters:\n- community_id: Community ID, for example: 1493290339532222469\n- ranking: Ranking, optional, default is None (upstream default), optional values are Relevance, Recency\n- cursor: Cursor, default is None, used for paging, obtained from `cursor` of the last response\n### Return:\n- Community timeline\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_twitter_web_fetch_community_timeline", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Community timeline", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "twitter fetch_community_timeline", "tags": [ "tikhub.twitter" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "6ad813d5e180" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/twitter/web/fetch_community_timeline", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_twitter_web_fetch_community_timeline", "method": "GET", "path": "/apis/v1/tikhub/twitter/web/fetch_community_timeline" }, "parameters": [ { "name": "community_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Community ID, for example: 1493290339532222469", "title": "Community Id" }, "description": "Community ID, for example: 1493290339532222469", "example": "1493290339532222469" }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "description": "Cursor, default is None, used for paging, obtained from `cursor` of the last response", "title": "Cursor" }, "description": "Cursor, default is None, used for paging, obtained from `cursor` of the last response" }, { "name": "ranking", "in": "query", "required": false, "schema": { "type": "string", "description": "Ranking, optional, default is None (upstream default), optional values are Relevance, Recency", "title": "Ranking" }, "description": "Ranking, optional, default is None (upstream default), optional values are Relevance, Recency" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e6c394f8c3c492a60c964d2b256bdea7b28191f41621783dfccaf70ed8ed9b06" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/twitter/web/fetch_community_timeline?community_id=1493290339532222469' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-twitter-web-fetch_community_timeline" } }, "/apis/v1/tikhub/twitter/web/fetch_latest_post_comments": { "get": { "description": "Twitter / X (web).\n\n### Purpose:\n- Get the latest tweet comments\n### Parameters:\n- tweet_id: Tweet ID\n- cursor: Cursor, default is None, used for paging, obtained from the last request\n### Return:\n- Tweet comments\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_twitter_web_fetch_latest_post_comments", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Tweet comments", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "twitter fetch_latest_post_comments", "tags": [ "tikhub.twitter" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a67c6e22c513" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/twitter/web/fetch_latest_post_comments", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_twitter_web_fetch_latest_post_comments", "method": "GET", "path": "/apis/v1/tikhub/twitter/web/fetch_latest_post_comments" }, "parameters": [ { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "description": "Cursor, default is None, used for paging, obtained from the last request", "title": "Cursor" }, "description": "Cursor, default is None, used for paging, obtained from the last request" }, { "name": "tweet_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Tweet ID", "title": "Tweet Id" }, "description": "Tweet ID", "example": "1808168603721650364" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:05c7216a1cf8e44e2221d2abae35b9dffeefa722009cbc02829f56ed6e2863f0" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/twitter/web/fetch_latest_post_comments?tweet_id=1808168603721650364' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-twitter-web-fetch_latest_post_comments" } }, "/apis/v1/tikhub/twitter/web/fetch_list_followers": { "get": { "description": "Twitter / X (web).\n\n### Purpose:\n- Get list followers\n### Parameters:\n- list_id: List ID, for example: 84839422\n- cursor: Cursor, default is None, used for paging, obtained from `next_cursor` of the last response\n### Return:\n- List followers\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_twitter_web_fetch_list_followers", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- List followers", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "twitter fetch_list_followers", "tags": [ "tikhub.twitter" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a0b6df56a4e4" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/twitter/web/fetch_list_followers", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_twitter_web_fetch_list_followers", "method": "GET", "path": "/apis/v1/tikhub/twitter/web/fetch_list_followers" }, "parameters": [ { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "description": "Cursor, default is None, used for paging, obtained from `next_cursor` of the last response", "title": "Cursor" }, "description": "Cursor, default is None, used for paging, obtained from `next_cursor` of the last response" }, { "name": "list_id", "in": "query", "required": true, "schema": { "type": "string", "description": "List ID, for example: 84839422", "title": "List Id" }, "description": "List ID, for example: 84839422", "example": "84839422" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:fcbdbd6d93d1bb44686196fcc76dccabd12b609302f0d146a994ec752bf588a3" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/twitter/web/fetch_list_followers?list_id=84839422' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-twitter-web-fetch_list_followers" } }, "/apis/v1/tikhub/twitter/web/fetch_list_members": { "get": { "description": "Twitter / X (web).\n\n### Purpose:\n- Get list members\n### Parameters:\n- list_id: List ID, for example: 84839422\n- cursor: Cursor, default is None, used for paging, obtained from `next_cursor` of the last response\n### Return:\n- List members\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_twitter_web_fetch_list_members", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- List members", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "twitter fetch_list_members", "tags": [ "tikhub.twitter" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "606e6ec2c61b" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/twitter/web/fetch_list_members", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_twitter_web_fetch_list_members", "method": "GET", "path": "/apis/v1/tikhub/twitter/web/fetch_list_members" }, "parameters": [ { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "description": "Cursor, default is None, used for paging, obtained from `next_cursor` of the last response", "title": "Cursor" }, "description": "Cursor, default is None, used for paging, obtained from `next_cursor` of the last response" }, { "name": "list_id", "in": "query", "required": true, "schema": { "type": "string", "description": "List ID, for example: 84839422", "title": "List Id" }, "description": "List ID, for example: 84839422", "example": "84839422" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:6cbe2f45279368771b9e15be40d5671b8cff5652d152d9a1b35924871bbb911b" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/twitter/web/fetch_list_members?list_id=84839422' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-twitter-web-fetch_list_members" } }, "/apis/v1/tikhub/twitter/web/fetch_list_timeline": { "get": { "description": "Twitter / X (web).\n\n### Purpose:\n- Get list timeline\n### Parameters:\n- list_id: List ID, for example: 84839422\n- cursor: Cursor, default is None, used for paging, obtained from `next_cursor` of the last response\n### Return:\n- List timeline\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_twitter_web_fetch_list_timeline", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- List timeline", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "twitter fetch_list_timeline", "tags": [ "tikhub.twitter" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "7e29fa8cc934" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/twitter/web/fetch_list_timeline", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_twitter_web_fetch_list_timeline", "method": "GET", "path": "/apis/v1/tikhub/twitter/web/fetch_list_timeline" }, "parameters": [ { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "description": "Cursor, default is None, used for paging, obtained from `next_cursor` of the last response", "title": "Cursor" }, "description": "Cursor, default is None, used for paging, obtained from `next_cursor` of the last response" }, { "name": "list_id", "in": "query", "required": true, "schema": { "type": "string", "description": "List ID, for example: 84839422", "title": "List Id" }, "description": "List ID, for example: 84839422", "example": "84839422" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:824979d05292d119ee04c4c6273dba2a3596e9bb33e716afec51b9c62bb7559a" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/twitter/web/fetch_list_timeline?list_id=84839422' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-twitter-web-fetch_list_timeline" } }, "/apis/v1/tikhub/twitter/web/fetch_post_comments": { "get": { "description": "Twitter / X (web).\n\n### Purpose:\n- Get comments under the tweet\n### Parameters:\n- tweet_id: Tweet ID\n- cursor: Cursor, default is None, used for paging, obtained from the last request\n### Return:\n- Comments\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_twitter_web_fetch_post_comments", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Comments", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "twitter fetch_post_comments", "tags": [ "tikhub.twitter" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "ce1e80132e7d" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/twitter/web/fetch_post_comments", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_twitter_web_fetch_post_comments", "method": "GET", "path": "/apis/v1/tikhub/twitter/web/fetch_post_comments" }, "parameters": [ { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "description": "Cursor, default is None, used for paging, obtained from the last request", "title": "Cursor" }, "description": "Cursor, default is None, used for paging, obtained from the last request" }, { "name": "tweet_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Tweet ID", "title": "Tweet Id" }, "description": "Tweet ID", "example": "1835124037934367098" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:9a0f652d89162064be1306352b1fa9dd20fe3ab6c7d67119b3f3cdb4eece58e9" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/twitter/web/fetch_post_comments?tweet_id=1835124037934367098' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-twitter-web-fetch_post_comments" } }, "/apis/v1/tikhub/twitter/web/fetch_retweet_user_list": { "get": { "description": "Twitter / X (web).\n\n### Purpose:\n- Get ReTweet User list\n### Parameters:\n- tweet_id: Tweet ID, can be obtained from the tweet link. For example: 1808168603721650364 in https://x.com/elonmusk/status/1808168603721650364\n- cursor: Cursor, default is None, used for paging, obtained from the last request\n### Return:\n- ReTweet User list\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_twitter_web_fetch_retweet_user_list", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- ReTweet User list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "twitter fetch_retweet_user_list", "tags": [ "tikhub.twitter" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "83e36c3e9eb2" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/twitter/web/fetch_retweet_user_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_twitter_web_fetch_retweet_user_list", "method": "GET", "path": "/apis/v1/tikhub/twitter/web/fetch_retweet_user_list" }, "parameters": [ { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "description": "Cursor, default is None, used for paging, obtained from the last request", "title": "Cursor" }, "description": "Cursor, default is None, used for paging, obtained from the last request" }, { "name": "tweet_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Tweet ID, can be obtained from the tweet link. For example: 1808168603721650364 in https://x.com/elonmusk/status/1808168603721650364", "title": "Tweet Id" }, "description": "Tweet ID, can be obtained from the tweet link. For example: 1808168603721650364 in https://x.com/elonmusk/status/1808168603721650364", "example": "1835124037934367098" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:aa2f8bd81517aa12e39b65e5600f11b32bb8898a14bfc6a5a193bcbdfe7596a1" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/twitter/web/fetch_retweet_user_list?tweet_id=1835124037934367098' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-twitter-web-fetch_retweet_user_list" } }, "/apis/v1/tikhub/twitter/web/fetch_search_communities": { "get": { "description": "Twitter / X (web).\n\n### Purpose:\n- Search communities\n### Parameters:\n- keyword: Search keyword, for example: superman\n- cursor: Cursor, default is None, used for paging, obtained from `next_cursor` of the last response\n### Return:\n- Community search results\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_twitter_web_fetch_search_communities", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Community search results", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "twitter fetch_search_communities", "tags": [ "tikhub.twitter" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "f3f2617723bf" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/twitter/web/fetch_search_communities", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_twitter_web_fetch_search_communities", "method": "GET", "path": "/apis/v1/tikhub/twitter/web/fetch_search_communities" }, "parameters": [ { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "description": "Cursor, default is None, used for paging, obtained from `next_cursor` of the last response", "title": "Cursor" }, "description": "Cursor, default is None, used for paging, obtained from `next_cursor` of the last response" }, { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Search Keyword", "title": "Keyword" }, "description": "Search Keyword", "example": "superman" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:21f5e9a5276b6a9766b40c278f366fbb82e82474d87b461d2a08295decd76962" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/twitter/web/fetch_search_communities?keyword=superman' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-twitter-web-fetch_search_communities" } }, "/apis/v1/tikhub/twitter/web/fetch_search_timeline": { "get": { "description": "Twitter / X (web).\n\n### Purpose:\n- Search\n### Parameters:\n- keyword: Search keyword\n- search_type: Search type, default is Top, other optional values are Latest, Media, People, Lists\n- cursor: Cursor, default is None, used for paging, obtained from the last request\n### Return:\n- Search results\n\n### Note on search result accuracy:\n- X's search does not guarantee the keyword or hashtag appears in the tweet text.\n- Matching happens against more than the caption — it can include the quoted tweet,\n linked article metadata, media, and account signals.\n- So a returned tweet can be a legitimate match with the term absent from the text field entirely.\n- Requiring a literal substring match in `text` will discard a large share of valid results,\n which is consistent with the 94.6% drop rate observed in practice.\n- If results look inaccurate, first check whether such a literal filter is being applied downstream.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_twitter_web_fetch_search_timeline", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Search results", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "twitter fetch_search_timeline", "tags": [ "tikhub.twitter" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "b6c478054c22" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/twitter/web/fetch_search_timeline", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_twitter_web_fetch_search_timeline", "method": "GET", "path": "/apis/v1/tikhub/twitter/web/fetch_search_timeline" }, "parameters": [ { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "description": "Cursor, default is None, used for paging, obtained from the last request", "title": "Cursor" }, "description": "Cursor, default is None, used for paging, obtained from the last request" }, { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Search Keyword", "title": "Keyword" }, "description": "Search Keyword", "example": "Elon Musk" }, { "name": "search_type", "in": "query", "required": false, "schema": { "type": "string", "description": "Search type, default is Top, other optional values are Latest, Media, People, Lists", "default": "Top", "title": "Search Type" }, "description": "Search type, default is Top, other optional values are Latest, Media, People, Lists", "example": "Top" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:ba2f9de6dd24c70aaa17b05c2f822e005f7b260ef9969a9b4f018207fac76ce9" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/twitter/web/fetch_search_timeline?keyword=Elon+Musk&search_type=Top' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-twitter-web-fetch_search_timeline" } }, "/apis/v1/tikhub/twitter/web/fetch_trending": { "get": { "description": "Twitter / X (web).\n\n### Purpose:\n- Get Trending\n### Parameters:\n- country: Country, default is UnitedStates, other optional values are as follows\n - China\n - India\n - Japan\n - Russia\n - Germany\n - Indonesia\n - Brazil\n - France\n - UnitedKingdom\n - Turkey\n - Italy\n - Mexico\n - SouthKorea\n - Canada\n - Spain\n - SaudiArabia\n - Egypt\n - Australia\n - Poland\n - Iran\n - Pakistan\n - Vietnam\n - Nigeria\n - Bangladesh\n - Netherlands\n - Argentina\n - Philippines\n - Malaysia\n - Colombia\n - UniteArabEmirates\n - Romania\n - Belgium\n - Switzerland\n - Singapore\n - Sweden\n - Norway\n - Austria\n - Kazakhstan\n - Algeria\n - Chile\n - Czechia\n - Peru\n\n### Return:\n- Trending\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_twitter_web_fetch_trending", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Trending", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "twitter fetch_trending", "tags": [ "tikhub.twitter" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "b4bd76192ff0" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/twitter/web/fetch_trending", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_twitter_web_fetch_trending", "method": "GET", "path": "/apis/v1/tikhub/twitter/web/fetch_trending" }, "parameters": [ { "name": "country", "in": "query", "required": false, "schema": { "type": "string", "description": "Country, default is UnitedStates, other optional values are as follows\n - China\n - India\n - Japan\n - Russia\n - Germany\n - Indonesia\n - Brazil\n - France\n - UnitedKingdom\n - Turkey\n - Italy\n - Mexico\n - SouthKorea\n - Canada\n - Spain\n - SaudiArabia\n - Egypt\n - Australia\n - Poland\n - Iran\n - Pakistan\n - Vietnam\n - Nigeria\n - Bangladesh\n - Netherlands\n - Argentina\n - Philippines\n - Malaysia\n - Colombia\n - UniteArabEmirates\n - Romania\n - Belgium\n - Switzerland\n - Singapore\n - Sweden\n - Norway\n - Austria\n - Kazakhstan\n - Algeria\n - Chile\n - Czechia\n - Peru", "default": "UnitedStates", "title": "Country" }, "description": "Country, default is UnitedStates, other optional values are as follows\n - China\n - India\n - Japan\n - Russia\n - Germany\n - Indonesia\n - Brazil\n - France\n - UnitedKingdom\n - Turkey\n - Italy\n - Mexico\n - SouthKorea\n - Canada\n - Spain\n - SaudiArabia\n - Egypt\n - Australia\n - Poland\n - Iran\n - Pakistan\n - Vietnam\n - Nigeria\n - Bangladesh\n - Netherlands\n - Argentina\n - Philippines\n - Malaysia\n - Colombia\n - UniteArabEmirates\n - Romania\n - Belgium\n - Switzerland\n - Singapore\n - Sweden\n - Norway\n - Austria\n - Kazakhstan\n - Algeria\n - Chile\n - Czechia\n - Peru", "example": "UnitedStates" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:decd56722f9000d950f81e2f1ef4ff1acaa91966d84c7c7940e372bc977fc033" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-twitter-web-fetch_trending" } }, "/apis/v1/tikhub/twitter/web/fetch_tweet_detail": { "get": { "description": "Twitter / X (web).\n\n### Purpose:\n- Get single tweet data\n### Parameters:\n- tweet_id: Tweet ID, can be obtained from the tweet link. For example: 1808168603721650364 in https://x.com/elonmusk/status/1808168603721650364\n### Return:\n- Tweet data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_twitter_web_fetch_tweet_detail", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Tweet data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "twitter fetch_tweet_detail", "tags": [ "tikhub.twitter" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "3e2ac0e58f1f" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/twitter/web/fetch_tweet_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_twitter_web_fetch_tweet_detail", "method": "GET", "path": "/apis/v1/tikhub/twitter/web/fetch_tweet_detail" }, "parameters": [ { "name": "tweet_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Tweet ID, can be obtained from the tweet link. For example: 1808168603721650364 in https://x.com/elonmusk/status/1808168603721650364", "title": "Tweet Id" }, "description": "Tweet ID, can be obtained from the tweet link. For example: 1808168603721650364 in https://x.com/elonmusk/status/1808168603721650364", "example": "1808168603721650364" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:409bc3958fe8310fc388352d86eb7ff795a8c3c576036adb26a19d7f7aa1b9fa" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/twitter/web/fetch_tweet_detail?tweet_id=1808168603721650364' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-twitter-web-fetch_tweet_detail" } }, "/apis/v1/tikhub/twitter/web/fetch_user_about": { "get": { "description": "Twitter / X (web).\n\n### Purpose:\n- Get user about profile\n### Parameters:\n- screen_name: Screen name, for example: elonmusk\n### Return:\n- User account profile info, including registration time, account status and usage\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_twitter_web_fetch_user_about", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- User account profile info, including registration time, account status and usage", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "twitter fetch_user_about", "tags": [ "tikhub.twitter" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "579103d7290f" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/twitter/web/fetch_user_about", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_twitter_web_fetch_user_about", "method": "GET", "path": "/apis/v1/tikhub/twitter/web/fetch_user_about" }, "parameters": [ { "name": "screen_name", "in": "query", "required": true, "schema": { "type": "string", "description": "Screen Name", "title": "Screen Name" }, "description": "Screen Name", "example": "elonmusk" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e211ea0a0d40f12fa1dc8a5128afc36454c5aafb68ad6cc819f55075e402ce3b" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/twitter/web/fetch_user_about?screen_name=elonmusk' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-twitter-web-fetch_user_about" } }, "/apis/v1/tikhub/twitter/web/fetch_user_affiliates": { "get": { "description": "Twitter / X (web).\n\n### Purpose:\n- Get user affiliates\n### Parameters:\n- screen_name: Screen name, for example: NASA. Must be an organization account that has affiliates; personal accounts return an empty list\n- cursor: Cursor, default is None, used for paging, obtained from `next_cursor` of the last response\n### Return:\n- User affiliate account list\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_twitter_web_fetch_user_affiliates", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- User affiliate account list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "twitter fetch_user_affiliates", "tags": [ "tikhub.twitter" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "66e34e603bcb" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/twitter/web/fetch_user_affiliates", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_twitter_web_fetch_user_affiliates", "method": "GET", "path": "/apis/v1/tikhub/twitter/web/fetch_user_affiliates" }, "parameters": [ { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "description": "Cursor, default is None, used for paging, obtained from `next_cursor` of the last response", "title": "Cursor" }, "description": "Cursor, default is None, used for paging, obtained from `next_cursor` of the last response" }, { "name": "screen_name", "in": "query", "required": true, "schema": { "type": "string", "description": "Screen name, for example: NASA. Must be an organization account that has affiliates; personal accounts return an empty list", "title": "Screen Name" }, "description": "Screen name, for example: NASA. Must be an organization account that has affiliates; personal accounts return an empty list", "example": "NASA" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:10ed6e362956a2abb12a73161f4a1dd3e83674bec1b542ac7d5174ec77814e96" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/twitter/web/fetch_user_affiliates?screen_name=NASA' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-twitter-web-fetch_user_affiliates" } }, "/apis/v1/tikhub/twitter/web/fetch_user_followers": { "get": { "description": "Twitter / X (web).\n\n### Purpose:\n- Get User Followers\n### Parameters:\n- screen_name: Screen Name, for example: elonmusk, can be obtained from the user's homepage link, for example: elonmusk in https://twitter.com/elonmusk\n- cursor: Cursor, default is None, used for paging, obtained from the last request\n### Return:\n- User Followers\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_twitter_web_fetch_user_followers", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- User Followers", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "twitter fetch_user_followers", "tags": [ "tikhub.twitter" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "cde4918bd533" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/twitter/web/fetch_user_followers", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_twitter_web_fetch_user_followers", "method": "GET", "path": "/apis/v1/tikhub/twitter/web/fetch_user_followers" }, "parameters": [ { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "description": "Cursor, default is None, used for paging, obtained from the last request", "title": "Cursor" }, "description": "Cursor, default is None, used for paging, obtained from the last request" }, { "name": "screen_name", "in": "query", "required": true, "schema": { "type": "string", "description": "Screen Name, for example: elonmusk, can be obtained from the user's homepage link, for example: elonmusk in https://twitter.com/elonmusk", "title": "Screen Name" }, "description": "Screen Name, for example: elonmusk, can be obtained from the user's homepage link, for example: elonmusk in https://twitter.com/elonmusk", "example": "elonmusk" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:08eda302e1f5882de09685f50fad2b8f723ff90851fda4b5934c337d4b430f24" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/twitter/web/fetch_user_followers?screen_name=elonmusk' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-twitter-web-fetch_user_followers" } }, "/apis/v1/tikhub/twitter/web/fetch_user_followings": { "get": { "description": "Twitter / X (web).\n\n### Purpose:\n- Get User Followings\n### Parameters:\n- screen_name: Screen Name, for example: elonmusk, can be obtained from the user's homepage link, for example: elonmusk in https://twitter.com/elonmusk\n- cursor: Cursor, default is None, used for paging, obtained from the last request\n### Return:\n- User Followings\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_twitter_web_fetch_user_followings", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- User Followings", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "twitter fetch_user_followings", "tags": [ "tikhub.twitter" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "989db7a10d11" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/twitter/web/fetch_user_followings", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_twitter_web_fetch_user_followings", "method": "GET", "path": "/apis/v1/tikhub/twitter/web/fetch_user_followings" }, "parameters": [ { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "description": "Cursor, default is None, used for paging, obtained from the last request", "title": "Cursor" }, "description": "Cursor, default is None, used for paging, obtained from the last request" }, { "name": "screen_name", "in": "query", "required": true, "schema": { "type": "string", "description": "Screen Name, for example: elonmusk, can be obtained from the user's homepage link, for example: elonmusk in https://twitter.com/elonmusk", "title": "Screen Name" }, "description": "Screen Name, for example: elonmusk, can be obtained from the user's homepage link, for example: elonmusk in https://twitter.com/elonmusk", "example": "elonmusk" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e349975a7ca1a97741630172b66e0984afa07607df0f387a8d14e570478332ab" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/twitter/web/fetch_user_followings?screen_name=elonmusk' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-twitter-web-fetch_user_followings" } }, "/apis/v1/tikhub/twitter/web/fetch_user_live_status": { "get": { "description": "Twitter / X (web).\n\n### Purpose:\n- Check user live status\n### Parameters:\n- rest_id: User rest ID (numeric), for example: 44196397\n### Return:\n- Current live status of the user\n\n### Note:\n- This endpoint requires `rest_id` (numeric user ID). Passing a screen name returns an upstream\n placeholder response (all fields set to \"s\"), not real data.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_twitter_web_fetch_user_live_status", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Current live status of the user", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "twitter fetch_user_live_status", "tags": [ "tikhub.twitter" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "2cda83c7bc93" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/twitter/web/fetch_user_live_status", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_twitter_web_fetch_user_live_status", "method": "GET", "path": "/apis/v1/tikhub/twitter/web/fetch_user_live_status" }, "parameters": [ { "name": "rest_id", "in": "query", "required": true, "schema": { "type": "string", "description": "User rest ID (numeric), for example: 44196397", "title": "Rest Id" }, "description": "User rest ID (numeric), for example: 44196397", "example": "44196397" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:c5a67551be635122bf1f23ad23ca486526ed876063ccbb5f776eea8204815d54" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/twitter/web/fetch_user_live_status?rest_id=44196397' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-twitter-web-fetch_user_live_status" } }, "/apis/v1/tikhub/twitter/web/fetch_user_media": { "get": { "description": "Twitter / X (web).\n\n### Purpose:\n- Get user media\n### Parameters:\n- screen_name: Screen Name, for example: elonmusk, can be obtained from the user's homepage link, for example: elonmusk in https://twitter.com/elonmusk\n- rest_id: User ID, for example: 44196397, if the user ID is used, the username will be ignored, only one of them can be selected.\n- cursor: Cursor, default is None, used for paging, obtained from the `next_cursor` in the last request\n### Return:\n- User media\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_twitter_web_fetch_user_media", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- User media", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "twitter fetch_user_media", "tags": [ "tikhub.twitter" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "dc7674a3a98c" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/twitter/web/fetch_user_media", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_twitter_web_fetch_user_media", "method": "GET", "path": "/apis/v1/tikhub/twitter/web/fetch_user_media" }, "parameters": [ { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "description": "Page Cursor\n\nUsage: Cursor, default is None, used for paging, obtained from the `next_cursor` in the last request", "title": "Cursor" }, "description": "Page Cursor\n\nUsage: Cursor, default is None, used for paging, obtained from the `next_cursor` in the last request" }, { "name": "rest_id", "in": "query", "required": false, "schema": { "type": "integer", "description": "User ID, for example: 44196397, if the user ID is used, the username will be ignored, only one of them can be selected.", "title": "Rest Id" }, "description": "User ID, for example: 44196397, if the user ID is used, the username will be ignored, only one of them can be selected.", "example": 44196397 }, { "name": "screen_name", "in": "query", "required": true, "schema": { "type": "string", "description": "Screen Name, for example: elonmusk, can be obtained from the user's homepage link, for example: elonmusk in https://twitter.com/elonmusk", "title": "Screen Name" }, "description": "Screen Name, for example: elonmusk, can be obtained from the user's homepage link, for example: elonmusk in https://twitter.com/elonmusk", "example": "elonmusk" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:7edaa3867f052e5652a8afbb2cea2e4cd6c9fbdf1bd7a701c210f8bad17a177f" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/twitter/web/fetch_user_media?rest_id=44196397&screen_name=elonmusk' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-twitter-web-fetch_user_media" } }, "/apis/v1/tikhub/twitter/web/fetch_user_post_tweet": { "get": { "description": "Twitter / X (web).\n\n### Purpose:\n- Get user post\n### Parameters:\n- screen_name: Screen Name, for example: elonmusk, can be obtained from the user's homepage link, for example: elonmusk in https://twitter.com/elonmusk\n- rest_id: User ID, for example: 44196397, if the user ID is used, the username will be ignored, only one of them can be selected.\n- cursor: Cursor, default is None, used for paging, obtained from the JSON in the last request.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_twitter_web_fetch_user_post_tweet", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "twitter fetch_user_post_tweet", "tags": [ "tikhub.twitter" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "17dbb4c9afd6" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/twitter/web/fetch_user_post_tweet", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_twitter_web_fetch_user_post_tweet", "method": "GET", "path": "/apis/v1/tikhub/twitter/web/fetch_user_post_tweet" }, "parameters": [ { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "description": "Cursor, default is None, used for paging, obtained from the JSON in the last request.", "title": "Cursor" }, "description": "Cursor, default is None, used for paging, obtained from the JSON in the last request." }, { "name": "rest_id", "in": "query", "required": false, "schema": { "type": "integer", "description": "User ID, for example: 44196397, if the user ID is used, the username will be ignored, only one of them can be selected.", "title": "Rest Id" }, "description": "User ID, for example: 44196397, if the user ID is used, the username will be ignored, only one of them can be selected.", "example": 44196397 }, { "name": "screen_name", "in": "query", "required": false, "schema": { "type": "string", "description": "Screen Name, for example: elonmusk, can be obtained from the user's homepage link, for example: elonmusk in https://twitter.com/elonmusk", "title": "Screen Name" }, "description": "Screen Name, for example: elonmusk, can be obtained from the user's homepage link, for example: elonmusk in https://twitter.com/elonmusk", "example": "elonmusk" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:27bbbea9f88f276297f7b8a4eda303b4ba36d4554a0c305527dbe53091614a42" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-twitter-web-fetch_user_post_tweet" } }, "/apis/v1/tikhub/twitter/web/fetch_user_profile": { "get": { "description": "Twitter / X (web).\n\n### Purpose:\n- Get user profile\n### Parameters:\n- screen_name: Screen Name, for example: elonmusk, can be obtained from the user's homepage link, for example: elonmusk in https://twitter.com/elonmusk\n- rest_id: User ID, for example: 44196397, if the user ID is used, the username will be ignored, only one of them can be selected.\n### Return:\n- User profile\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_twitter_web_fetch_user_profile", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- User profile", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "twitter fetch_user_profile", "tags": [ "tikhub.twitter" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "02b90e6555d8" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/twitter/web/fetch_user_profile", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_twitter_web_fetch_user_profile", "method": "GET", "path": "/apis/v1/tikhub/twitter/web/fetch_user_profile" }, "parameters": [ { "name": "rest_id", "in": "query", "required": false, "schema": { "type": "integer", "description": "User ID (If the user ID is used, the user name will be ignored\n\nUsage: User ID, for example: 44196397, if the user ID is used, the username will be ignored, only one of them can be selected.", "title": "Rest Id" }, "description": "User ID (If the user ID is used, the user name will be ignored\n\nUsage: User ID, for example: 44196397, if the user ID is used, the username will be ignored, only one of them can be selected.", "example": 44196397 }, { "name": "screen_name", "in": "query", "required": false, "schema": { "type": "string", "description": "Screen Name, for example: elonmusk, can be obtained from the user's homepage link, for example: elonmusk in https://twitter.com/elonmusk", "title": "Screen Name" }, "description": "Screen Name, for example: elonmusk, can be obtained from the user's homepage link, for example: elonmusk in https://twitter.com/elonmusk", "example": "elonmusk" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:4e54c702978d925e3dc9a1e7d79f0d1aa9955413f1912c11ef671bc877951e58" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-twitter-web-fetch_user_profile" } }, "/apis/v1/tikhub/twitter/web/fetch_user_profiles_by_rest_ids": { "get": { "description": "Twitter / X (web).\n\n### Purpose:\n- Get profiles by rest ids\n### Parameters:\n- rest_ids: User IDs, comma separated, for example: 44196397,34743251\n### Return:\n- User profile list\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_twitter_web_fetch_user_profiles_by_rest_ids", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- User profile list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "twitter fetch_user_profiles_by_rest_ids", "tags": [ "tikhub.twitter" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "7f5eb0724c9b" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/twitter/web/fetch_user_profiles_by_rest_ids", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_twitter_web_fetch_user_profiles_by_rest_ids", "method": "GET", "path": "/apis/v1/tikhub/twitter/web/fetch_user_profiles_by_rest_ids" }, "parameters": [ { "name": "rest_ids", "in": "query", "required": true, "schema": { "type": "string", "description": "User IDs, comma separated, for example: 44196397,34743251", "title": "Rest Ids" }, "description": "User IDs, comma separated, for example: 44196397,34743251", "example": "44196397,34743251" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:eb37f7b022d6ba0425b259f31793566cc31f655410715cd42f51b246569b25e5" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/twitter/web/fetch_user_profiles_by_rest_ids?rest_ids=44196397%2C34743251' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-twitter-web-fetch_user_profiles_by_rest_ids" } }, "/apis/v1/tikhub/twitter/web/fetch_user_tweet_replies": { "get": { "description": "Twitter / X (web).\n\n### Purpose:\n- Get user tweet replies\n### Parameters:\n- screen_name: Screen Name, for example: elonmusk, can be obtained from the user's homepage link, for example: elonmusk in https://twitter.com/elonmusk\n- cursor: Cursor, default is None, used for paging, obtained from the last request\n### Return:\n- User tweet replies\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_twitter_web_fetch_user_tweet_replies", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- User tweet replies", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "twitter fetch_user_tweet_replies", "tags": [ "tikhub.twitter" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "c879edc7152a" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/twitter/web/fetch_user_tweet_replies", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_twitter_web_fetch_user_tweet_replies", "method": "GET", "path": "/apis/v1/tikhub/twitter/web/fetch_user_tweet_replies" }, "parameters": [ { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "description": "Cursor, default is None, used for paging, obtained from the last request", "title": "Cursor" }, "description": "Cursor, default is None, used for paging, obtained from the last request" }, { "name": "screen_name", "in": "query", "required": true, "schema": { "type": "string", "description": "Screen Name, for example: elonmusk, can be obtained from the user's homepage link, for example: elonmusk in https://twitter.com/elonmusk", "title": "Screen Name" }, "description": "Screen Name, for example: elonmusk, can be obtained from the user's homepage link, for example: elonmusk in https://twitter.com/elonmusk", "example": "elonmusk" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:668f73b0735ff0b95413a6207344833cd40a15b6a0ac8b968c193c26262fa772" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/twitter/web/fetch_user_tweet_replies?screen_name=elonmusk' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-twitter-web-fetch_user_tweet_replies" } }, "/apis/v1/tikhub/wechat_channels/v2/fetch_channel_id_to_username": { "post": { "description": "WeChat Channels (v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Resolve a publicly visible Channel ID (`sph…` short ID) into a finder username (`v2_…@finder`).\n- With the username you can then call `fetch_user_videos`, `fetch_channel_info`, `fetch_user_profile`, etc.\n\n- ⏱️ Due to WeChat server latency, this endpoint responds slowly; please set your client request timeout to 30 seconds — a timeout that is too small may result in being billed without receiving the response.\n\n### Parameters\n- channel_id: Channel ID (`sph…` short ID), e.g. `sphi9BjV8GK0Zsl` (People's Daily). Must start with `sph`.\n- raw: Optional, default True. True=raw response; False=simplified parsed structure.\n\n### Return\n- Resolved finder username plus account nickname and description\n\n### Response structure & JSON Path\n#### `raw=false` (simplified):\n- Input echo: `$.data.channel_id`\n- Resolved finder username (feed directly into downstream endpoints): `$.data.username`\n- Account nickname (search highlight markers stripped): `$.data.nickname`\n- Account description: `$.data.desc` (may be null)\n- On miss: `$.data.username` is null with an explanation at `$.data.error`\n#### `raw=true` (raw):\n- Result groups: `$.data.data[N]` (each group has `type` + `items[]` / `subBoxes[].items[]`)\n- Finder username inside account items: `$.data.data[N].items[M].jumpInfo.userName` or `$.data.data[N].items[M].noticeParam.finderUsername`\n- Title / description: `$.data.data[N].items[M].title` / `.desc`\n- Others: `$.data.query` (query echo), `$.data.continueFlag`, `$.data.offset`\n- Mapping: `username` / `nickname` / `desc` of raw=false are extracted from the first `@finder` account item in `data[].items[]` (or `subBoxes[].items[]`) of raw=true.\n\nAPI references: `fetch_channel_info` = `POST /tikhub/wechat_channels/v2/fetch_channel_info` (operationId: `post_tikhub_wechat_channels_v2_fetch_channel_info`); `fetch_user_profile` = `POST /tikhub/wechat_channels/v2/fetch_user_profile` (operationId: `post_tikhub_wechat_channels_v2_fetch_user_profile`); `fetch_user_videos` = `POST /tikhub/wechat_channels/v2/fetch_user_videos` (operationId: `post_tikhub_wechat_channels_v2_fetch_user_videos`).\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_wechat_channels_v2_fetch_channel_id_to_username", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Resolved finder username plus account nickname and description\n\n### Response structure & JSON Path\n#### `raw=false` (simplified):\n- Input echo: `$.data.channel_id`\n- Resolved finder username (feed directly into downstream endpoints): `$.data.username`\n- Account nickname (search highlight markers stripped): `$.data.nickname`\n- Account description: `$.data.desc` (may be null)\n- On miss: `$.data.username` is null with an explanation at `$.data.error`\n#### `raw=true` (raw):\n- Result groups: `$.data.data[N]` (each group has `type` + `items[]` / `subBoxes[].items[]`)\n- Finder username inside account items: `$.data.data[N].items[M].jumpInfo.userName` or `$.data.data[N].items[M].noticeParam.finderUsername`\n- Title / description: `$.data.data[N].items[M].title` / `.desc`\n- Others: `$.data.query` (query echo), `$.data.continueFlag`, `$.data.offset`\n- Mapping: `username` / `nickname` / `desc` of raw=false are extracted from the first `@finder` account item in `data[].items[]` (or `subBoxes[].items[]`) of raw=true.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "wechat_channels fetch_channel_id_to_username", "tags": [ "tikhub.wechat_channels" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "8da46f649254" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/wechat_channels/v2/fetch_channel_id_to_username", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_wechat_channels_v2_fetch_channel_id_to_username", "method": "POST", "path": "/apis/v1/tikhub/wechat_channels/v2/fetch_channel_id_to_username" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "channel_id": { "type": "string", "maxLength": 64, "pattern": "^sph[A-Za-z0-9_-]+$", "title": "Channel Id", "description": "WeChat Channels ID (short ID starting with sph\n\nUsage: Channel ID (`sph…` short ID), e.g. `sphi9BjV8GK0Zsl` (People's Daily). Must start with `sph`.", "example": "sphi9BjV8GK0Zsl" }, "raw": { "type": "boolean", "title": "Raw", "description": "True=raw response; False=simplified parsed structure", "default": false } }, "type": "object", "required": [ "channel_id" ], "title": "FetchChannelIdToUsernameRequest" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:cfff5126e58072d1e1b0ae26db7f2fd0de07ee095605b1a2bdb8e37156692437" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/wechat_channels/v2/fetch_channel_id_to_username \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"channel_id\": \"sphi9BjV8GK0Zsl\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-wechat_channels-v2-fetch_channel_id_to_username" } }, "/apis/v1/tikhub/wechat_channels/v2/fetch_channel_info": { "post": { "description": "WeChat Channels (v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get the \"More Info\" of a WeChat Channels account: basic info section (IP location / profile location / **Channel ID** = public sph ID) + verification section (service unit / entity type / internet news service license number / service category / verification time).\n\n- ⏱️ Due to WeChat server latency, this endpoint responds slowly; please set your client request timeout to 30 seconds — a timeout that is too small may result in being billed without receiving the response.\n\n### Parameters\n- username: WeChat Channels finder username (`v2_…@finder` format), e.g. `v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder` (People's Daily).\n - How to get it:\n - The `username` field of each video object in `fetch_video_detail` / `fetch_user_videos` responses (most common)\n - `fetch_channel_id_to_username`: convert a Channel ID (`sph…` short ID, e.g. `sphi9BjV8GK0Zsl`) into a finder username\n- raw: Optional, default True. True=raw response; False=simplified parsed structure.\n\n### Return\n- Basic info and verification info of the WeChat Channels account\n\n### Response structure & JSON Path\n#### `raw=false` (simplified):\n- Account username: `$.data.finder_username`\n- Channel ID (sph short ID): `$.data.channel_id`\n- Section list (original section structure preserved): `$.data.sections[N].title`, `$.data.sections[N].items[M].title` / `.content`\n- Flattened \"title→content\" dict (most useful): `$.data.info`, e.g. `$.data.info['视频号ID']`, `$.data.info['IP归属地']`, `$.data.info['服务单位']`, `$.data.info['主体类型']`, `$.data.info['互联网新闻信息服务许可证编号']`, `$.data.info['服务类别']`, `$.data.info['认证时间']`\n#### `raw=true` (raw):\n- Status code: `$.data.baseResponse.ret` (0=success)\n- Section array (camelCase): `$.data.sections[N].title`, `$.data.sections[N].items[M].title` / `.content` / `.type` / `.jumpInfo`\n- Mapping: `info`/`channel_id` of raw=false correspond to `sections[].items[]` of raw=true (flattened by title with rich-text image markers stripped); raw=true does **not** contain the flattened `info` dict or `channel_id`, extract them from sections yourself.\n\nAPI references: `fetch_channel_id_to_username` = `POST /tikhub/wechat_channels/v2/fetch_channel_id_to_username` (operationId: `post_tikhub_wechat_channels_v2_fetch_channel_id_to_username`); `fetch_user_videos` = `POST /tikhub/wechat_channels/v2/fetch_user_videos` (operationId: `post_tikhub_wechat_channels_v2_fetch_user_videos`); `fetch_video_detail` = `POST /tikhub/wechat_channels/v2/fetch_video_detail` (operationId: `post_tikhub_wechat_channels_v2_fetch_video_detail`).\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_wechat_channels_v2_fetch_channel_info", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Basic info and verification info of the WeChat Channels account\n\n### Response structure & JSON Path\n#### `raw=false` (simplified):\n- Account username: `$.data.finder_username`\n- Channel ID (sph short ID): `$.data.channel_id`\n- Section list (original section structure preserved): `$.data.sections[N].title`, `$.data.sections[N].items[M].title` / `.content`\n- Flattened \"title→content\" dict (most useful): `$.data.info`, e.g. `$.data.info['视频号ID']`, `$.data.info['IP归属地']`, `$.data.info['服务单位']`, `$.data.info['主体类型']`, `$.data.info['互联网新闻信息服务许可证编号']`, `$.data.info['服务类别']`, `$.data.info['认证时间']`\n#### `raw=true` (raw):\n- Status code: `$.data.baseResponse.ret` (0=success)\n- Section array (camelCase): `$.data.sections[N].title`, `$.data.sections[N].items[M].title` / `.content` / `.type` / `.jumpInfo`\n- Mapping: `info`/`channel_id` of raw=false correspond to `sections[].items[]` of raw=true (flattened by title with rich-text image markers stripped); raw=true does **not** contain the flattened `info` dict or `channel_id`, extract them from sections yourself.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "wechat_channels fetch_channel_info", "tags": [ "tikhub.wechat_channels" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "7d51a41a092a" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/wechat_channels/v2/fetch_channel_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_wechat_channels_v2_fetch_channel_info", "method": "POST", "path": "/apis/v1/tikhub/wechat_channels/v2/fetch_channel_info" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "username": { "type": "string", "maxLength": 256, "minLength": 10, "pattern": "^v2_[0-9a-fA-F]+@finder$", "title": "Username", "description": "WeChat Channels finder username (`v2_…@finder` format), e.g. `v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder` (People's Daily).\n - How to get it:\n - The `username` field of each video object in `fetch_video_detail` / `fetch_user_videos` responses (most common)\n - `fetch_channel_id_to_username`: convert a Channel ID (`sph…` short ID, e.g. `sphi9BjV8GK0Zsl`) into a finder username\n\nAPI references: `fetch_channel_id_to_username` = `POST /tikhub/wechat_channels/v2/fetch_channel_id_to_username` (operationId: `post_tikhub_wechat_channels_v2_fetch_channel_id_to_username`); `fetch_user_videos` = `POST /tikhub/wechat_channels/v2/fetch_user_videos` (operationId: `post_tikhub_wechat_channels_v2_fetch_user_videos`); `fetch_video_detail` = `POST /tikhub/wechat_channels/v2/fetch_video_detail` (operationId: `post_tikhub_wechat_channels_v2_fetch_video_detail`).", "example": "v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder" }, "raw": { "type": "boolean", "title": "Raw", "description": "True=raw response; False=simplified parsed structure", "default": true } }, "type": "object", "required": [ "username" ], "title": "FetchChannelInfoRequest" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:4994c9e7edcfe84d25de15c4d9bbb308609e1c6439e41802c0fd7e6cea18c97e" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/wechat_channels/v2/fetch_channel_info \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"username\": \"v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-wechat_channels-v2-fetch_channel_info" } }, "/apis/v1/tikhub/wechat_channels/v2/fetch_collection_videos": { "post": { "description": "WeChat Channels (v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Given a collection `topic_id` (from `fetch_user_collections`), return the video list inside that collection.\n- Each video carries a `media` object (`url` / `url_token` / `decode_key`) ready for download and decryption.\n- Supports pagination for more videos.\n\n- ⏱️ Due to WeChat server latency, this endpoint responds slowly; please set your client request timeout to 30 seconds — a timeout that is too small may result in being billed without receiving the response.\n- ⚠️ Large-integer ID precision: IDs such as `id` / `topic_id` in the response are 64-bit big integers beyond JavaScript's safe-integer range (2^53-1). Always receive / pass such IDs as **strings** (parse JSON with json-bigint or read them as text), never through JS `Number`. Swagger UI rounds the trailing digits of huge integers in its docs view — this is expected and does not affect the actual data returned by the API.\n\n### Parameters\n- topic_id: Collection ID (numeric, from `topic_id` of `fetch_user_collections`). E.g. `14616794565351966924` .\n- topic: Optional, collection name, improves hit rate. Use the exact collection name returned by fetch_user_collections.\n- username: Optional, creator finder username (`v2_…@finder` format), improves hit rate.\n- last_buffer: Optional pagination cursor (base64), **leave empty for the first page**; when `down_continue` is truthy, pass the previous page's `last_buffer`.\n- topic_type: Optional, collection type, default 16 (align with the collection's `topic_type` from `fetch_user_collections`).\n- raw: Optional, default True. True=raw response; False=simplified parsed structure (recommended for media download).\n\n### Return\n- Video list of the collection with pagination cursor\n\n### Response structure & JSON Path\n#### `raw=false` (simplified, snake_case, **recommended for media download**):\n- `$.data.topic_id` / `$.data.title` (collection name)\n- `$.data.total_count` — total videos in the collection; `$.data.count` — items on this page (e.g. 20)\n- `$.data.videos[]` — video array, per item (N is the index):\n - `$.data.videos[N].id` — video objectId (feed into `fetch_video_detail` / `fetch_video_comments`)\n - `$.data.videos[N].username` / `.nickname` / `.title` (may be null) / `.create_time`\n - `$.data.videos[N].read_count` / `.like_count` / `.fav_count` / `.forward_count` / `.comment_count`\n - `$.data.videos[N].media` — media object (single), download + decrypt:\n - `$.data.videos[N].media.url` — video CDN link (without Token)\n - `$.data.videos[N].media.url_token` — Token of the CDN link (anti-hotlinking)\n - `$.data.videos[N].media.full_url` — pre-concatenated full CDN URL (= `url` + `url_token`, ready to download)\n - `$.data.videos[N].media.decode_key` — video decryption key (**different on every request**)\n - Also `cover_url` / `duration` / `width` / `height` / `media_type` etc.\n- `$.data.down_continue` — has next page (1=yes)\n- `$.data.last_buffer` — pagination cursor (pass back to this endpoint for the next page)\n#### `raw=true` (full raw response, camelCase):\n- `$.data.totalCount` → `total_count`\n- `$.data.object[]` → `videos[]` (full video objects), per item:\n - `$.data.object[N].id` → `id`; `$.data.object[N].username` → `username`\n - Media at `$.data.object[N].objectDesc.media[0]`: `.url` → `url`, `.urlToken` → `url_token`, `.decodeKey` → `decode_key` (`full_url` is produced by the simplified layer; for raw, concatenate `url` + `urlToken` yourself)\n- `$.data.downContinueFlag` → `down_continue` (note: raw top level also has `continueFlag`; for collection pagination use `downContinueFlag`)\n- `$.data.lastBuffer` (alias `$.data.last_buffer`) → `last_buffer`\n\n### Important Note (video download & decryption)\n- Same as `fetch_video_detail`: accessing `url` directly may fail due to anti-hotlinking, download via `full_url` (Token already appended); if the MP4 cannot be played it is encrypted, decrypt with the `decode_key` from the **same response** (the `decode_key` changes on every request).\n- Online decryption tool: https://evil0ctal.github.io/WeChat-Channels-Video-File-Decryption/\n- Self-deployable decryption API (one-click Docker deployment): https://github.com/Evil0ctal/WeChat-Channels-Video-File-Decryption\n\nAPI references: `fetch_user_collections` = `POST /tikhub/wechat_channels/v2/fetch_user_collections` (operationId: `post_tikhub_wechat_channels_v2_fetch_user_collections`); `fetch_video_comments` = `POST /tikhub/wechat_channels/v2/fetch_video_comments` (operationId: `post_tikhub_wechat_channels_v2_fetch_video_comments`); `fetch_video_detail` = `POST /tikhub/wechat_channels/v2/fetch_video_detail` (operationId: `post_tikhub_wechat_channels_v2_fetch_video_detail`).\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_wechat_channels_v2_fetch_collection_videos", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Video list of the collection with pagination cursor\n\n### Response structure & JSON Path\n#### `raw=false` (simplified, snake_case, **recommended for media download**):\n- `$.data.topic_id` / `$.data.title` (collection name)\n- `$.data.total_count` — total videos in the collection; `$.data.count` — items on this page (e.g. 20)\n- `$.data.videos[]` — video array, per item (N is the index):\n - `$.data.videos[N].id` — video objectId (feed into `fetch_video_detail` / `fetch_video_comments`)\n - `$.data.videos[N].username` / `.nickname` / `.title` (may be null) / `.create_time`\n - `$.data.videos[N].read_count` / `.like_count` / `.fav_count` / `.forward_count` / `.comment_count`\n - `$.data.videos[N].media` — media object (single), download + decrypt:\n - `$.data.videos[N].media.url` — video CDN link (without Token)\n - `$.data.videos[N].media.url_token` — Token of the CDN link (anti-hotlinking)\n - `$.data.videos[N].media.full_url` — pre-concatenated full CDN URL (= `url` + `url_token`, ready to download)\n - `$.data.videos[N].media.decode_key` — video decryption key (**different on every request**)\n - Also `cover_url` / `duration` / `width` / `height` / `media_type` etc.\n- `$.data.down_continue` — has next page (1=yes)\n- `$.data.last_buffer` — pagination cursor (pass back to this endpoint for the next page)\n#### `raw=true` (full raw response, camelCase):\n- `$.data.totalCount` → `total_count`\n- `$.data.object[]` → `videos[]` (full video objects), per item:\n - `$.data.object[N].id` → `id`; `$.data.object[N].username` → `username`\n - Media at `$.data.object[N].objectDesc.media[0]`: `.url` → `url`, `.urlToken` → `url_token`, `.decodeKey` → `decode_key` (`full_url` is produced by the simplified layer; for raw, concatenate `url` + `urlToken` yourself)\n- `$.data.downContinueFlag` → `down_continue` (note: raw top level also has `continueFlag`; for collection pagination use `downContinueFlag`)\n- `$.data.lastBuffer` (alias `$.data.last_buffer`) → `last_buffer`\n\nAPI references: `fetch_video_comments` = `POST /tikhub/wechat_channels/v2/fetch_video_comments` (operationId: `post_tikhub_wechat_channels_v2_fetch_video_comments`); `fetch_video_detail` = `POST /tikhub/wechat_channels/v2/fetch_video_detail` (operationId: `post_tikhub_wechat_channels_v2_fetch_video_detail`).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "wechat_channels fetch_collection_videos", "tags": [ "tikhub.wechat_channels" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "51727b694504" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/wechat_channels/v2/fetch_collection_videos", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_wechat_channels_v2_fetch_collection_videos", "method": "POST", "path": "/apis/v1/tikhub/wechat_channels/v2/fetch_collection_videos" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "topic_id": { "type": "string", "maxLength": 32, "pattern": "^[0-9]+$", "title": "Topic Id", "description": "Numeric collection ID from topic_id of fetch_user_collections, for example \"14616794565351966924\".\n\nAPI references: `fetch_user_collections` = `POST /tikhub/wechat_channels/v2/fetch_user_collections` (operationId: `post_tikhub_wechat_channels_v2_fetch_user_collections`).", "example": "14616794565351966924" }, "topic": { "title": "Topic", "description": "Optional collection name; use the name returned by fetch_user_collections to improve the match.\n\nAPI references: `fetch_user_collections` = `POST /tikhub/wechat_channels/v2/fetch_user_collections` (operationId: `post_tikhub_wechat_channels_v2_fetch_user_collections`).", "default": "", "example": "早安中国", "type": [ "string", "null" ], "maxLength": 100 }, "username": { "title": "Username", "description": "Optional, creator finder username (`v2_…@finder` format), improves hit rate.", "default": "", "example": "v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder", "type": [ "string", "null" ], "maxLength": 256, "pattern": "^(v2_[0-9a-fA-F]+@finder)?$" }, "last_buffer": { "title": "Last Buffer", "description": "Optional pagination cursor (base64), **leave empty for the first page**; when `down_continue` is truthy, pass the previous page's `last_buffer`.", "default": "", "type": [ "string", "null" ], "pattern": "^[A-Za-z0-9+/=_-]*$" }, "topic_type": { "type": "integer", "maximum": 1000.0, "minimum": 0.0, "title": "Topic Type", "description": "Optional, collection type, default 16 (align with the collection's `topic_type` from `fetch_user_collections`).\n\nAPI references: `fetch_user_collections` = `POST /tikhub/wechat_channels/v2/fetch_user_collections` (operationId: `post_tikhub_wechat_channels_v2_fetch_user_collections`).", "default": 16 }, "raw": { "type": "boolean", "title": "Raw", "description": "True=raw response; False=simplified parsed structure (recommended for media download", "default": true } }, "type": "object", "required": [ "topic_id" ], "title": "FetchCollectionVideosRequest" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:acef4da9cb0a37ef27a5261143c09e5bf9f58b50af1fed431ef371ad701ebd10" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/wechat_channels/v2/fetch_collection_videos \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"topic_id\": \"14616794565351966924\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-wechat_channels-v2-fetch_collection_videos" } }, "/apis/v1/tikhub/wechat_channels/v2/fetch_live_detail": { "post": { "description": "WeChat Channels (v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Pass a live `live_id` to get live-room detail: anchor info, live status, online count, replay info, etc.\n\n- ⏱️ Due to WeChat server latency, this endpoint responds slowly; please set your client request timeout to 30 seconds — a timeout that is too small may result in being billed without receiving the response.\n- ⚠️ Large-integer ID precision: IDs such as `live_id` in the response are 64-bit big integers beyond JavaScript's safe-integer range (2^53-1). Always receive / pass such IDs as **strings** (parse JSON with json-bigint or read them as text), never through JS `Number`. Swagger UI rounds the trailing digits of huge integers in its docs view — this is expected and does not affect the actual data returned by the API.\n\n### Parameters\n- live_id: Live ID (numeric). Source: replay items of `fetch_live_history`, live entry, or live share. E.g. `2078950291205875194`.\n- scene: Optional, entry scene, default 5.\n- finder_username: Optional, anchor finder username (`v2_…@finder` format), improves hit rate. E.g. `v2_060000231003b20faec8cae1811ac4d5c702ea32b0771737aa785454f7f8177114cc4d248d66@finder` (Huxiu).\n- raw: Optional, default True. True=raw response; False=simplified parsed structure.\n\n### Return\n- Live room detail\n\n### Response structure & JSON Path\n#### `raw=false` (simplified, snake_case):\n- `$.data.live_id` — live ID; `$.data.object_id` — associated video objectId (may be empty string)\n- `$.data.anchor_nickname` / `$.data.anchor_username` / `$.data.anchor_head_url` — anchor nickname / username / avatar\n- `$.data.live_cover_url` — live cover\n- `$.data.live_status` — live status (1=live / 2=ended …); `$.data.status_desc` — status text (may be empty)\n- `$.data.online_count` / `$.data.max_online_count` — current / peak online count (usually 0 for ended lives)\n- `$.data.replay_status` — replay status; `$.data.replay_url` — replay address (may be empty); `$.data.replay_watch_uv` — replay viewer count\n#### `raw=true` (full raw response, camelCase):\n- `$.data.liveInfo.liveId` → `live_id`; `$.data.liveInfo.objectId` → `object_id`\n- `$.data.liveInfo.liveStatus` → `live_status`; `$.data.liveInfo.statusDesc` → `status_desc`\n- `$.data.liveInfo.onlineCnt` → `online_count`; `$.data.liveInfo.maxOnlineCount` → `max_online_count`\n- `$.data.liveInfo.replayStatus` → `replay_status`; `$.data.liveInfo.replayUrl` → `replay_url`\n- `$.data.liveInfo.replayInfo.watchUv` → `replay_watch_uv`\n- `$.data.anchorContact` (`nickname` / `username` / `headUrl` / `coverImgUrl` / `liveCoverImgUrl`) → anchor-related fields\n- Also dozens of raw fields like `$.data.liveCover`, `$.data.anchorInfo`, `$.data.replaySubscribedCount`\n\nAPI references: `fetch_live_history` = `POST /tikhub/wechat_channels/v2/fetch_live_history` (operationId: `post_tikhub_wechat_channels_v2_fetch_live_history`).\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_wechat_channels_v2_fetch_live_detail", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Live room detail\n\n### Response structure & JSON Path\n#### `raw=false` (simplified, snake_case):\n- `$.data.live_id` — live ID; `$.data.object_id` — associated video objectId (may be empty string)\n- `$.data.anchor_nickname` / `$.data.anchor_username` / `$.data.anchor_head_url` — anchor nickname / username / avatar\n- `$.data.live_cover_url` — live cover\n- `$.data.live_status` — live status (1=live / 2=ended …); `$.data.status_desc` — status text (may be empty)\n- `$.data.online_count` / `$.data.max_online_count` — current / peak online count (usually 0 for ended lives)\n- `$.data.replay_status` — replay status; `$.data.replay_url` — replay address (may be empty); `$.data.replay_watch_uv` — replay viewer count\n#### `raw=true` (full raw response, camelCase):\n- `$.data.liveInfo.liveId` → `live_id`; `$.data.liveInfo.objectId` → `object_id`\n- `$.data.liveInfo.liveStatus` → `live_status`; `$.data.liveInfo.statusDesc` → `status_desc`\n- `$.data.liveInfo.onlineCnt` → `online_count`; `$.data.liveInfo.maxOnlineCount` → `max_online_count`\n- `$.data.liveInfo.replayStatus` → `replay_status`; `$.data.liveInfo.replayUrl` → `replay_url`\n- `$.data.liveInfo.replayInfo.watchUv` → `replay_watch_uv`\n- `$.data.anchorContact` (`nickname` / `username` / `headUrl` / `coverImgUrl` / `liveCoverImgUrl`) → anchor-related fields\n- Also dozens of raw fields like `$.data.liveCover`, `$.data.anchorInfo`, `$.data.replaySubscribedCount`", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "wechat_channels fetch_live_detail", "tags": [ "tikhub.wechat_channels" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "534c310aaedc" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/wechat_channels/v2/fetch_live_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_wechat_channels_v2_fetch_live_detail", "method": "POST", "path": "/apis/v1/tikhub/wechat_channels/v2/fetch_live_detail" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "live_id": { "type": "string", "maxLength": 32, "pattern": "^[0-9]+$", "title": "Live Id", "description": "Live ID (numeric). Source: replay items of `fetch_live_history`, live entry, or live share. E.g. `2078950291205875194`.\n\nAPI references: `fetch_live_history` = `POST /tikhub/wechat_channels/v2/fetch_live_history` (operationId: `post_tikhub_wechat_channels_v2_fetch_live_history`).", "example": "2078950291205875194" }, "scene": { "type": "integer", "maximum": 1000.0, "minimum": 0.0, "title": "Scene", "description": "Entry scene, default 5", "default": 5 }, "finder_username": { "title": "Finder Username", "description": "Optional, anchor finder username (`v2_…@finder` format), improves hit rate. E.g. `v2_060000231003b20faec8cae1811ac4d5c702ea32b0771737aa785454f7f8177114cc4d248d66@finder` (Huxiu).", "default": "", "example": "v2_060000231003b20faec8cae1811ac4d5c702ea32b0771737aa785454f7f8177114cc4d248d66@finder", "type": [ "string", "null" ], "maxLength": 256, "pattern": "^(v2_[0-9a-fA-F]+@finder)?$" }, "raw": { "type": "boolean", "title": "Raw", "description": "True=raw response; False=simplified parsed structure", "default": true } }, "type": "object", "required": [ "live_id" ], "title": "FetchLiveDetailRequest" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:2ece9e4d02e7351290444082b83241e2aada380a4d009a60cb75a844eb8fc011" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/wechat_channels/v2/fetch_live_detail \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"live_id\": \"2078950291205875194\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-wechat_channels-v2-fetch_live_detail" } }, "/apis/v1/tikhub/wechat_channels/v2/fetch_live_history": { "post": { "description": "WeChat Channels (v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get a creator's live replay list. Each replay is itself a video object with a `media` object (`url` / `url_token` / `decode_key`) ready for download and decryption.\n- Supports pagination for more replays.\n\n- ⏱️ Due to WeChat server latency, this endpoint responds slowly; please set your client request timeout to 30 seconds — a timeout that is too small may result in being billed without receiving the response.\n- ⚠️ Large-integer ID precision: IDs such as `id` in the response are 64-bit big integers beyond JavaScript's safe-integer range (2^53-1). Always receive / pass such IDs as **strings** (parse JSON with json-bigint or read them as text), never through JS `Number`. Swagger UI rounds the trailing digits of huge integers in its docs view — this is expected and does not affect the actual data returned by the API.\n\n### Parameters\n- username: WeChat Channels finder username (`v2_…@finder` format). Example (an account with live replays): `v2_060000231003b20faec8cae1811ac4d5c702ea32b0771737aa785454f7f8177114cc4d248d66@finder` (Huxiu).\n- last_buffer: Optional pagination cursor (base64), **leave empty for the first page**; when `continue_flag` is truthy, pass the previous page's `last_buffer`.\n- flag: Optional fetch flag, default 12.\n- raw: Optional, default True. True=raw response; False=simplified parsed structure (recommended for media download).\n\n### Return\n- Live replay list with pagination cursor\n\n### Response structure & JSON Path\n#### `raw=false` (simplified, snake_case, **recommended for media download**):\n- `$.data.username`\n- `$.data.count` — items on this page; `$.data.total_count` — total replays (**0 when none**)\n- `$.data.lives[]` — replay array, each item is a video object (same shape as videos of `fetch_collection_videos`), per item (N is the index):\n - `$.data.lives[N].id` — replay video objectId\n - `$.data.lives[N].username` / `.nickname` / `.title` / `.create_time`\n - `$.data.lives[N].like_count` / `.fav_count` / `.forward_count` / `.comment_count` etc.\n - `$.data.lives[N].media` — media object (single), download + decrypt:\n - `$.data.lives[N].media.url` — video CDN link (without Token)\n - `$.data.lives[N].media.url_token` — Token of the CDN link (anti-hotlinking)\n - `$.data.lives[N].media.full_url` — pre-concatenated full CDN URL (= `url` + `url_token`, ready to download)\n - `$.data.lives[N].media.decode_key` — video decryption key (**different on every request**)\n- `$.data.continue_flag` — has next page (1=yes)\n- `$.data.last_buffer` — pagination cursor (pass back to this endpoint for the next page)\n#### `raw=true` (full raw response, camelCase):\n- `$.data.totalCount` → `total_count`\n- `$.data.object[]` → `lives[]` (full video objects), media per item at `$.data.object[N].objectDesc.media[0]`: `.url` → `url`, `.urlToken` → `url_token`, `.decodeKey` → `decode_key` (`full_url` is produced by the simplified layer; for raw, concatenate `url` + `urlToken` yourself)\n- `$.data.continueFlag` → `continue_flag`\n- `$.data.lastBuffer` (alias `$.data.last_buffer`) → `last_buffer`\n\n### Important Note (video download & decryption)\n- Same as `fetch_video_detail`: download via `full_url` (Token already appended); if the MP4 cannot be played it is encrypted, decrypt with the `decode_key` from the **same response**.\n- The `live_id` of a replay (live-room dimension) can be fed into `fetch_live_detail`.\n- Online decryption tool: https://evil0ctal.github.io/WeChat-Channels-Video-File-Decryption/\n- Self-deployable decryption API (one-click Docker deployment): https://github.com/Evil0ctal/WeChat-Channels-Video-File-Decryption\n\nAPI references: `fetch_collection_videos` = `POST /tikhub/wechat_channels/v2/fetch_collection_videos` (operationId: `post_tikhub_wechat_channels_v2_fetch_collection_videos`); `fetch_live_detail` = `POST /tikhub/wechat_channels/v2/fetch_live_detail` (operationId: `post_tikhub_wechat_channels_v2_fetch_live_detail`); `fetch_video_detail` = `POST /tikhub/wechat_channels/v2/fetch_video_detail` (operationId: `post_tikhub_wechat_channels_v2_fetch_video_detail`).\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_wechat_channels_v2_fetch_live_history", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Live replay list with pagination cursor\n\n### Response structure & JSON Path\n#### `raw=false` (simplified, snake_case, **recommended for media download**):\n- `$.data.username`\n- `$.data.count` — items on this page; `$.data.total_count` — total replays (**0 when none**)\n- `$.data.lives[]` — replay array, each item is a video object (same shape as videos of `fetch_collection_videos`), per item (N is the index):\n - `$.data.lives[N].id` — replay video objectId\n - `$.data.lives[N].username` / `.nickname` / `.title` / `.create_time`\n - `$.data.lives[N].like_count` / `.fav_count` / `.forward_count` / `.comment_count` etc.\n - `$.data.lives[N].media` — media object (single), download + decrypt:\n - `$.data.lives[N].media.url` — video CDN link (without Token)\n - `$.data.lives[N].media.url_token` — Token of the CDN link (anti-hotlinking)\n - `$.data.lives[N].media.full_url` — pre-concatenated full CDN URL (= `url` + `url_token`, ready to download)\n - `$.data.lives[N].media.decode_key` — video decryption key (**different on every request**)\n- `$.data.continue_flag` — has next page (1=yes)\n- `$.data.last_buffer` — pagination cursor (pass back to this endpoint for the next page)\n#### `raw=true` (full raw response, camelCase):\n- `$.data.totalCount` → `total_count`\n- `$.data.object[]` → `lives[]` (full video objects), media per item at `$.data.object[N].objectDesc.media[0]`: `.url` → `url`, `.urlToken` → `url_token`, `.decodeKey` → `decode_key` (`full_url` is produced by the simplified layer; for raw, concatenate `url` + `urlToken` yourself)\n- `$.data.continueFlag` → `continue_flag`\n- `$.data.lastBuffer` (alias `$.data.last_buffer`) → `last_buffer`\n\nAPI references: `fetch_collection_videos` = `POST /tikhub/wechat_channels/v2/fetch_collection_videos` (operationId: `post_tikhub_wechat_channels_v2_fetch_collection_videos`).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "wechat_channels fetch_live_history", "tags": [ "tikhub.wechat_channels" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "b8b952e456e3" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/wechat_channels/v2/fetch_live_history", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_wechat_channels_v2_fetch_live_history", "method": "POST", "path": "/apis/v1/tikhub/wechat_channels/v2/fetch_live_history" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "username": { "type": "string", "maxLength": 256, "minLength": 10, "pattern": "^v2_[0-9a-fA-F]+@finder$", "title": "Username", "description": "WeChat Channels finder username (`v2_…@finder` format). Example (an account with live replays): `v2_060000231003b20faec8cae1811ac4d5c702ea32b0771737aa785454f7f8177114cc4d248d66@finder` (Huxiu).", "example": "v2_060000231003b20faec8cae1811ac4d5c702ea32b0771737aa785454f7f8177114cc4d248d66@finder" }, "last_buffer": { "title": "Last Buffer", "description": "Optional pagination cursor (base64), **leave empty for the first page**; when `continue_flag` is truthy, pass the previous page's `last_buffer`.", "default": "", "type": [ "string", "null" ], "pattern": "^[A-Za-z0-9+/=_-]*$" }, "flag": { "type": "integer", "maximum": 1000.0, "minimum": 0.0, "title": "Flag", "description": "Fetch flag, default 12", "default": 12 }, "raw": { "type": "boolean", "title": "Raw", "description": "True=raw response; False=simplified parsed structure (recommended for media download", "default": true } }, "type": "object", "required": [ "username" ], "title": "FetchLiveHistoryRequest" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:4ab6af8bfad6f4eb0445241bcd75bd37eaefa7639e74ab0392c1fa9ab8b6aa8b" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/wechat_channels/v2/fetch_live_history \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"username\": \"v2_060000231003b20faec8cae1811ac4d5c702ea32b0771737aa785454f7f8177114cc4d248d66@finder\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-wechat_channels-v2-fetch_live_history" } }, "/apis/v1/tikhub/wechat_channels/v2/fetch_search_channel_videos": { "post": { "description": "WeChat Channels (v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- In-channel search: search a creator's published videos by keyword **within that channel only**.\n- **Single page per call.** When `continue_flag=1` and `next_cursor` is non-empty, pass `next_cursor` back verbatim as the `cursor` parameter to get the next page.\n- `next_cursor` is an **opaque string** — do not parse or concatenate it. Upstream seals it (older versions leaked search-session state in plaintext).\n\n- ⏱️ Due to WeChat server latency, this endpoint responds slowly; please set your client request timeout to 30 seconds — a timeout that is too small may result in being billed without receiving the response.\n- ⚠️ Large-integer ID precision: IDs such as `doc_id` in the response are 64-bit big integers beyond JavaScript's safe-integer range (2^53-1). Always receive / pass such IDs as **strings** (parse JSON with json-bigint or read them as text), never through JS `Number`. Swagger UI rounds the trailing digits of huge integers in its docs view — this is expected and does not affect the actual data returned by the API.\n\n### Parameters\n- username: Creator finder username (`v2_…@finder` format). E.g. `v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder` (People's Daily).\n- keyword: Keyword to search within the channel (1-100 chars after trimming). For example, `news`.\n- raw: Optional, default True. True=raw search response; False=simplified parsed structure.\n\n### Return\n- In-channel search hit list\n\n### Response structure & JSON Path\n#### `raw=false` (simplified, snake_case):\n- `$.data.username` / `$.data.keyword` — input echo\n- `$.data.count` — hits on this page (e.g. 20)\n- `$.data.items[]` — hit array, per item (N is the index):\n - `$.data.items[N].type` — result type (e.g. `video`)\n - `$.data.items[N].doc_id` — document id\n - `$.data.items[N].title` — title (search highlight markers stripped)\n - `$.data.items[N].desc` / `.thumb_url` / `.username` / `.nickname` — description / thumbnail / author (**may be null for some items**)\n- `$.data.continue_flag` — has more (1=yes)\n- `$.data.next_cursor` — pagination cursor (opaque string; pass it back as `cursor` for the next page, `null` when there is no next page)\n#### `raw=true` (full raw response, camelCase):\n- `$.data.query` → `keyword`; `$.data.offset` — next page offset (e.g. 20)\n- `$.data.data[]` — result group array; hit items are nested at `$.data.data[N].subBoxes[M].items[]` (or possibly `$.data.data[N].items[]`), flattened into `items[]` by the simplified layer\n- `$.data.continueFlag` → `continue_flag`\n- `$.data.next_cursor` — same as `raw=false`: opaque pagination cursor (injected at top level). Older versions exposed `searchID` and other search context in plaintext; upstream no longer returns it\n\n### Tip\n- To get media (download address / decode_key) of a hit video: this endpoint does not return `media` directly; feed the hit into `fetch_video_detail` to get `media` (`url` / `url_token` / `decode_key`). See `fetch_video_detail` docs for the chain and decryption notes.\n\nAPI references: `fetch_video_detail` = `POST /tikhub/wechat_channels/v2/fetch_video_detail` (operationId: `post_tikhub_wechat_channels_v2_fetch_video_detail`).\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_wechat_channels_v2_fetch_search_channel_videos", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- In-channel search hit list\n\n### Response structure & JSON Path\n#### `raw=false` (simplified, snake_case):\n- `$.data.username` / `$.data.keyword` — input echo\n- `$.data.count` — hits on this page (e.g. 20)\n- `$.data.items[]` — hit array, per item (N is the index):\n - `$.data.items[N].type` — result type (e.g. `video`)\n - `$.data.items[N].doc_id` — document id\n - `$.data.items[N].title` — title (search highlight markers stripped)\n - `$.data.items[N].desc` / `.thumb_url` / `.username` / `.nickname` — description / thumbnail / author (**may be null for some items**)\n- `$.data.continue_flag` — has more (1=yes)\n- `$.data.next_cursor` — pagination cursor (opaque string; pass it back as `cursor` for the next page, `null` when there is no next page)\n#### `raw=true` (full raw response, camelCase):\n- `$.data.query` → `keyword`; `$.data.offset` — next page offset (e.g. 20)\n- `$.data.data[]` — result group array; hit items are nested at `$.data.data[N].subBoxes[M].items[]` (or possibly `$.data.data[N].items[]`), flattened into `items[]` by the simplified layer\n- `$.data.continueFlag` → `continue_flag`\n- `$.data.next_cursor` — same as `raw=false`: opaque pagination cursor (injected at top level). Older versions exposed `searchID` and other search context in plaintext; upstream no longer returns it", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "wechat_channels fetch_search_channel_videos", "tags": [ "tikhub.wechat_channels" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "31ac0912d301" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/wechat_channels/v2/fetch_search_channel_videos", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_wechat_channels_v2_fetch_search_channel_videos", "method": "POST", "path": "/apis/v1/tikhub/wechat_channels/v2/fetch_search_channel_videos" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "username": { "type": "string", "maxLength": 256, "minLength": 10, "pattern": "^v2_[0-9a-fA-F]+@finder$", "title": "Username", "description": "Creator finder username (v2_…@finder format", "example": "v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder" }, "keyword": { "type": "string", "maxLength": 100, "minLength": 1, "title": "Keyword", "description": "Keyword to search within this channel (1-100 chars", "example": "news" }, "cursor": { "title": "Cursor", "description": "Pagination cursor. Leave empty for the first page, then pass the previous response next_cursor verbatim. The cursor is opaque; do not parse or concatenate it.", "type": [ "string", "null" ], "maxLength": 4096 }, "raw": { "type": "boolean", "title": "Raw", "description": "True=raw response; False=simplified parsed structure", "default": true } }, "type": "object", "required": [ "username", "keyword" ], "title": "FetchSearchChannelVideosRequest" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:87b76d7a1c4365274cf001f1bd4afb51573efd49c49a09c4e15c263ad6f845cb" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-wechat_channels-v2-fetch_search_channel_videos" } }, "/apis/v1/tikhub/wechat_channels/v2/fetch_user_collections": { "post": { "description": "WeChat Channels (v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get the \"Collections\" list on a creator's homepage. Pass each collection's `topic_id` to `fetch_collection_videos` to get its videos.\n\n- ⏱️ Due to WeChat server latency, this endpoint responds slowly; please set your client request timeout to 30 seconds — a timeout that is too small may result in being billed without receiving the response.\n- ⚠️ Large-integer ID precision: IDs such as `topic_id` in the response are 64-bit big integers beyond JavaScript's safe-integer range (2^53-1). Always receive / pass such IDs as **strings** (parse JSON with json-bigint or read them as text), never through JS `Number`. Swagger UI rounds the trailing digits of huge integers in its docs view — this is expected and does not affect the actual data returned by the API.\n\n### Parameters\n- username: WeChat Channels finder username (`v2_…@finder` format). E.g. `v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder` (People's Daily).\n- raw: Optional, default True. True=raw response; False=simplified parsed structure.\n\n### Return\n- Collection list\n\n### Response structure & JSON Path\n#### `raw=false` (simplified, snake_case):\n- `$.data.username` — finder username\n- `$.data.count` — total collections (e.g. 6)\n- `$.data.collections[]` — collection array, per item (N is the index):\n - `$.data.collections[N].topic_id` — collection ID (numeric, pass to `fetch_collection_videos`, e.g. `14616794565351966924`)\n - `$.data.collections[N].name` — collection name \n - `$.data.collections[N].desc` — collection description (may be empty string)\n - `$.data.collections[N].cover_url` — collection cover\n - `$.data.collections[N].feed_count` — number of videos in the collection\n - `$.data.collections[N].topic_type` — collection type (e.g. 16, matches `topic_type` of `fetch_collection_videos`)\n#### `raw=true` (full raw response, camelCase):\n- `$.data.collectionCount` → `count`\n- `$.data.collectionInfo[]` → `collections[]`, per item:\n - `$.data.collectionInfo[N].collectionTopicId` → `topic_id` (number; `collectionTopicIdStr` provides a string alias)\n - `$.data.collectionInfo[N].collectionName` → `name`\n - `$.data.collectionInfo[N].collectionDesc` → `desc`\n - `$.data.collectionInfo[N].coverImgUrl` → `cover_url`\n - `$.data.collectionInfo[N].feedCount` → `feed_count`\n - `$.data.collectionInfo[N].collectionTopicType` → `topic_type`\n - Also raw fields like `lastUpdateTime` / `readCount` / `categoryId`\n- `$.data.lastBuffer` — pagination cursor of the collection list (usually empty; few collections, no pagination needed)\n\nAPI references: `fetch_collection_videos` = `POST /tikhub/wechat_channels/v2/fetch_collection_videos` (operationId: `post_tikhub_wechat_channels_v2_fetch_collection_videos`).\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_wechat_channels_v2_fetch_user_collections", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Collection list\n\n### Response structure & JSON Path\n#### `raw=false` (simplified, snake_case):\n- `$.data.username` — finder username\n- `$.data.count` — total collections (e.g. 6)\n- `$.data.collections[]` — collection array, per item (N is the index):\n - `$.data.collections[N].topic_id` — collection ID (numeric, pass to `fetch_collection_videos`, e.g. `14616794565351966924`)\n - `$.data.collections[N].name` — collection name \n - `$.data.collections[N].desc` — collection description (may be empty string)\n - `$.data.collections[N].cover_url` — collection cover\n - `$.data.collections[N].feed_count` — number of videos in the collection\n - `$.data.collections[N].topic_type` — collection type (e.g. 16, matches `topic_type` of `fetch_collection_videos`)\n#### `raw=true` (full raw response, camelCase):\n- `$.data.collectionCount` → `count`\n- `$.data.collectionInfo[]` → `collections[]`, per item:\n - `$.data.collectionInfo[N].collectionTopicId` → `topic_id` (number; `collectionTopicIdStr` provides a string alias)\n - `$.data.collectionInfo[N].collectionName` → `name`\n - `$.data.collectionInfo[N].collectionDesc` → `desc`\n - `$.data.collectionInfo[N].coverImgUrl` → `cover_url`\n - `$.data.collectionInfo[N].feedCount` → `feed_count`\n - `$.data.collectionInfo[N].collectionTopicType` → `topic_type`\n - Also raw fields like `lastUpdateTime` / `readCount` / `categoryId`\n- `$.data.lastBuffer` — pagination cursor of the collection list (usually empty; few collections, no pagination needed)\n\nAPI references: `fetch_collection_videos` = `POST /tikhub/wechat_channels/v2/fetch_collection_videos` (operationId: `post_tikhub_wechat_channels_v2_fetch_collection_videos`).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "wechat_channels fetch_user_collections", "tags": [ "tikhub.wechat_channels" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "efae4c4c19c6" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/wechat_channels/v2/fetch_user_collections", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_wechat_channels_v2_fetch_user_collections", "method": "POST", "path": "/apis/v1/tikhub/wechat_channels/v2/fetch_user_collections" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "username": { "type": "string", "maxLength": 256, "minLength": 10, "pattern": "^v2_[0-9a-fA-F]+@finder$", "title": "Username", "description": "WeChat Channels finder username (`v2_…@finder` format). E.g. `v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder` (People's Daily).", "example": "v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder" }, "raw": { "type": "boolean", "title": "Raw", "description": "True=raw response; False=simplified parsed structure", "default": true } }, "type": "object", "required": [ "username" ], "title": "FetchUserCollectionsRequest" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:f9c8c7a5a9badf7fe16305c2f25a2522f648e1cd3b57ca608722152e82c326d6" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/wechat_channels/v2/fetch_user_collections \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"username\": \"v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-wechat_channels-v2-fetch_user_collections" } }, "/apis/v1/tikhub/wechat_channels/v2/fetch_user_profile": { "post": { "description": "WeChat Channels (v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get a creator's homepage profile and interaction stats. **Complementary** to `fetch_channel_info` (verification entity / license): this endpoint provides nickname / signature / avatar, follower / video / like / favorite / forward counts, live duration, IP region, collection count, linked official accounts, etc.\n\n- ⏱️ Due to WeChat server latency, this endpoint responds slowly; please set your client request timeout to 30 seconds — a timeout that is too small may result in being billed without receiving the response.\n\n### Parameters\n- username: WeChat Channels finder username (`v2_…@finder` format). Source: the `username` field of video objects in `fetch_video_detail` / `fetch_user_videos` responses; or convert a `sph…` short ID via `fetch_channel_id_to_username`. E.g. `v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder` (People's Daily).\n- raw: Optional, default True. True=raw response; False=simplified parsed structure.\n\n### Return\n- Account homepage profile and interaction stats\n\n### Response structure & JSON Path\n#### `raw=false` (simplified, flattened snake_case):\n- `$.data.username` — finder username\n- `$.data.nickname` / `$.data.signature` / `$.data.head_url` (avatar) / `$.data.region` (IP region)\n- `$.data.fans_count` — follower count. **Note: some accounts (e.g. People's Daily) return 0**\n- `$.data.feeds_count` — video count (e.g. 10555)\n- `$.data.like_count` / `$.data.fav_count` / `$.data.forward_count` — like / favorite / forward counts (0 for some accounts)\n- `$.data.friend_follow_count` — friend-follow count\n- `$.data.live_duration_hours` — accumulated live streaming hours\n- `$.data.original_flag` — original-content flag\n- `$.data.collection_count` — collection count (e.g. 6; details via `fetch_user_collections`)\n- `$.data.verify_desc` — verification description (may be null)\n- `$.data.linked_accounts[]` — linked official accounts `[{nickname, type}]` \n#### `raw=true` (full raw response, nested camelCase):\n- `$.data.contact.nickname` / `.signature` / `.headUrl` → `nickname` / `signature` / `head_url`\n- `$.data.contact.username` → `username`; `$.data.contact.originalFlag` → `original_flag`\n- `$.data.contact.authInfo` (`authProfession` / `authIconType` …) — verification info\n- `$.data.ipRegionInfo.regionText` → `region`\n- `$.data.fansCount` → `fans_count` (also 0 for some accounts); `$.data.feedsCount` → `feeds_count`\n- `$.data.feedsLikeCount` / `.feedsFavCount` / `.feedsForwardCount` → `like_count` / `fav_count` / `forward_count`\n- `$.data.liveDurationHours` → `live_duration_hours`; `$.data.collectionListInfo.collectionCount` → `collection_count`\n- `$.data.bizInfo.info[]` (`bizNickname` / `serviceTypeName`) → `linked_accounts[]`\n- Also contains dozens of raw fields like `$.data.object[]` (first-screen video list), `$.data.anchorStatInfo` (live session stats), `$.data.lastBuffer` / `$.data.continueFlag` (pagination of the first-screen videos; generally unused here since this endpoint is for profile data).\n\nAPI references: `fetch_channel_id_to_username` = `POST /tikhub/wechat_channels/v2/fetch_channel_id_to_username` (operationId: `post_tikhub_wechat_channels_v2_fetch_channel_id_to_username`); `fetch_channel_info` = `POST /tikhub/wechat_channels/v2/fetch_channel_info` (operationId: `post_tikhub_wechat_channels_v2_fetch_channel_info`); `fetch_user_collections` = `POST /tikhub/wechat_channels/v2/fetch_user_collections` (operationId: `post_tikhub_wechat_channels_v2_fetch_user_collections`); `fetch_user_videos` = `POST /tikhub/wechat_channels/v2/fetch_user_videos` (operationId: `post_tikhub_wechat_channels_v2_fetch_user_videos`); `fetch_video_detail` = `POST /tikhub/wechat_channels/v2/fetch_video_detail` (operationId: `post_tikhub_wechat_channels_v2_fetch_video_detail`).\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_wechat_channels_v2_fetch_user_profile", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Account homepage profile and interaction stats\n\n### Response structure & JSON Path\n#### `raw=false` (simplified, flattened snake_case):\n- `$.data.username` — finder username\n- `$.data.nickname` / `$.data.signature` / `$.data.head_url` (avatar) / `$.data.region` (IP region)\n- `$.data.fans_count` — follower count. **Note: some accounts (e.g. People's Daily) return 0**\n- `$.data.feeds_count` — video count (e.g. 10555)\n- `$.data.like_count` / `$.data.fav_count` / `$.data.forward_count` — like / favorite / forward counts (0 for some accounts)\n- `$.data.friend_follow_count` — friend-follow count\n- `$.data.live_duration_hours` — accumulated live streaming hours\n- `$.data.original_flag` — original-content flag\n- `$.data.collection_count` — collection count (e.g. 6; details via `fetch_user_collections`)\n- `$.data.verify_desc` — verification description (may be null)\n- `$.data.linked_accounts[]` — linked official accounts `[{nickname, type}]` \n#### `raw=true` (full raw response, nested camelCase):\n- `$.data.contact.nickname` / `.signature` / `.headUrl` → `nickname` / `signature` / `head_url`\n- `$.data.contact.username` → `username`; `$.data.contact.originalFlag` → `original_flag`\n- `$.data.contact.authInfo` (`authProfession` / `authIconType` …) — verification info\n- `$.data.ipRegionInfo.regionText` → `region`\n- `$.data.fansCount` → `fans_count` (also 0 for some accounts); `$.data.feedsCount` → `feeds_count`\n- `$.data.feedsLikeCount` / `.feedsFavCount` / `.feedsForwardCount` → `like_count` / `fav_count` / `forward_count`\n- `$.data.liveDurationHours` → `live_duration_hours`; `$.data.collectionListInfo.collectionCount` → `collection_count`\n- `$.data.bizInfo.info[]` (`bizNickname` / `serviceTypeName`) → `linked_accounts[]`\n- Also contains dozens of raw fields like `$.data.object[]` (first-screen video list), `$.data.anchorStatInfo` (live session stats), `$.data.lastBuffer` / `$.data.continueFlag` (pagination of the first-screen videos; generally unused here since this endpoint is for profile data).\n\nAPI references: `fetch_user_collections` = `POST /tikhub/wechat_channels/v2/fetch_user_collections` (operationId: `post_tikhub_wechat_channels_v2_fetch_user_collections`).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "wechat_channels fetch_user_profile", "tags": [ "tikhub.wechat_channels" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "64d35b30cb56" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/wechat_channels/v2/fetch_user_profile", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_wechat_channels_v2_fetch_user_profile", "method": "POST", "path": "/apis/v1/tikhub/wechat_channels/v2/fetch_user_profile" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "username": { "type": "string", "maxLength": 256, "minLength": 10, "pattern": "^v2_[0-9a-fA-F]+@finder$", "title": "Username", "description": "WeChat Channels finder username (`v2_…@finder` format). Source: the `username` field of video objects in `fetch_video_detail` / `fetch_user_videos` responses; or convert a `sph…` short ID via `fetch_channel_id_to_username`. E.g. `v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder` (People's Daily).\n\nAPI references: `fetch_channel_id_to_username` = `POST /tikhub/wechat_channels/v2/fetch_channel_id_to_username` (operationId: `post_tikhub_wechat_channels_v2_fetch_channel_id_to_username`); `fetch_user_videos` = `POST /tikhub/wechat_channels/v2/fetch_user_videos` (operationId: `post_tikhub_wechat_channels_v2_fetch_user_videos`); `fetch_video_detail` = `POST /tikhub/wechat_channels/v2/fetch_video_detail` (operationId: `post_tikhub_wechat_channels_v2_fetch_video_detail`).", "example": "v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder" }, "raw": { "type": "boolean", "title": "Raw", "description": "True=raw response; False=simplified parsed structure", "default": true } }, "type": "object", "required": [ "username" ], "title": "FetchUserProfileRequest" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:f421c5854649ee8307dc3e3ccff60d6b9ffd3e691c1b0b25df00460fca6f80d6" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/wechat_channels/v2/fetch_user_profile \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"username\": \"v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-wechat_channels-v2-fetch_user_profile" } }, "/apis/v1/tikhub/wechat_channels/v2/fetch_user_videos": { "post": { "description": "WeChat Channels (v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get the video list from a WeChat Channels account's homepage.\n- Each video carries a `media` object (`url` / `url_token` / `full_url` / `decode_key`) ready for download and decryption.\n- Supports pagination for more videos.\n\n- ⏱️ Due to WeChat server latency, this endpoint responds slowly; please set your client request timeout to 30 seconds — a timeout that is too small may result in being billed without receiving the response.\n- ⚠️ Large-integer ID precision: IDs such as `id` / `object_nonce_id` in the response are 64-bit big integers beyond JavaScript's safe-integer range (2^53-1). Always receive / pass such IDs as **strings** (parse JSON with json-bigint or read them as text), never through JS `Number`. Swagger UI rounds the trailing digits of huge integers in its docs view — this is expected and does not affect the actual data returned by the API.\n\n### Parameters\n- username: WeChat Channels finder username (`v2_…@finder` format), e.g. `v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder` (People's Daily). See `fetch_channel_info` / `fetch_video_detail` / `fetch_channel_id_to_username` docs for how to obtain it.\n- last_buffer: Optional pagination cursor (base64). **Leave empty for the first page**; when `up_continue` in the response is truthy, pass the previous page's `last_buffer` to get the next page. (base64 contains `+//=` characters, hence body instead of query.)\n- raw: Optional, default True. True=raw response; False=simplified parsed structure (recommended for media download).\n\n### Return\n- User video list with pagination cursor\n\n### Response structure & JSON Path\n#### `raw=false` (simplified, recommended):\n- Top level: `$.data.username` / `$.data.nickname` / `$.data.count` (videos on this page) / `$.data.up_continue` (has next page) / `$.data.last_buffer` (pagination cursor)\n- Each video `$.data.videos[N]` (N is the index):\n - `id` (video objectId, feed into `fetch_video_detail` / `fetch_video_comments`): `$.data.videos[N].id`\n - `object_nonce_id`: `$.data.videos[N].object_nonce_id`\n - `username` / `nickname` / `title`: `$.data.videos[N].username` etc.\n - Interaction counts: `$.data.videos[N].read_count` / `.like_count` / `.fav_count` / `.forward_count` / `.comment_count`\n - Publish time: `$.data.videos[N].create_time`\n - Location: `$.data.videos[N].location`\n#### `raw=true` (raw):\n- Status code: `$.data.baseResponse.ret`\n- Video array (note: singular **`object`**, camelCase): `$.data.object[N]`\n- Pagination: `$.data.upContinueFlag`, `$.data.lastBuffer` (alias `$.data.last_buffer` also provided)\n- Account profile: `$.data.contact` (nickname/signature/`authInfo` etc.), `$.data.finderUserInfo`\n- Mapping: `videos[]` of raw=false corresponds to `object[]` of raw=true; `nickname` comes from `finderUserInfo` / `contact.nickname`.\n\n### Important Note (video download & decryption)\n- Accessing the `url` field directly may fail to open the video page — WeChat Channels uses **anti-hotlinking**. Concatenate `url` and `url_token` into a full URL and download via any HTTP client (opening = HTTP 200, **does not mean playable**, the file is encrypted).\n- ⚠️ **Video Encryption Notice**: If the downloaded MP4 cannot be played, it is encrypted. Use the `decode_key` field from the response together with the encrypted file to decrypt it.\n- ⚠️ **Important**: WeChat returns a **new encrypted link and `decode_key` on every request** (even for the same video). Make sure the `decode_key` and the downloaded encrypted file come from the **same API response**, otherwise decryption will fail.\n- JSON Path (per video — N is the index):\n - `raw=false` (**recommended for media download**) — `$.data.videos[N].media` is a single object:\n - Video CDN link (without Token): `$.data.videos[N].media.url`\n - Token of the video CDN link: `$.data.videos[N].media.url_token`\n - Pre-concatenated full CDN URL (= url + url_token, ready to use): `$.data.videos[N].media.full_url`\n - Video decryption key (different on every request): `$.data.videos[N].media.decode_key`\n - `raw=true` — media is nested at `$.data.object[N].objectDesc.media[0]` (camelCase: `url` / `urlToken` / `decodeKey`, full URL = `url` + `urlToken`). For media download, prefer `raw=false` for cleaner paths.\n- Online decryption tool: https://evil0ctal.github.io/WeChat-Channels-Video-File-Decryption/\n- Self-deployable decryption API (one-click Docker deployment): https://github.com/Evil0ctal/WeChat-Channels-Video-File-Decryption\n\nAPI references: `fetch_channel_id_to_username` = `POST /tikhub/wechat_channels/v2/fetch_channel_id_to_username` (operationId: `post_tikhub_wechat_channels_v2_fetch_channel_id_to_username`); `fetch_channel_info` = `POST /tikhub/wechat_channels/v2/fetch_channel_info` (operationId: `post_tikhub_wechat_channels_v2_fetch_channel_info`); `fetch_video_comments` = `POST /tikhub/wechat_channels/v2/fetch_video_comments` (operationId: `post_tikhub_wechat_channels_v2_fetch_video_comments`); `fetch_video_detail` = `POST /tikhub/wechat_channels/v2/fetch_video_detail` (operationId: `post_tikhub_wechat_channels_v2_fetch_video_detail`).\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_wechat_channels_v2_fetch_user_videos", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- User video list with pagination cursor\n\n### Response structure & JSON Path\n#### `raw=false` (simplified, recommended):\n- Top level: `$.data.username` / `$.data.nickname` / `$.data.count` (videos on this page) / `$.data.up_continue` (has next page) / `$.data.last_buffer` (pagination cursor)\n- Each video `$.data.videos[N]` (N is the index):\n - `id` (video objectId, feed into `fetch_video_detail` / `fetch_video_comments`): `$.data.videos[N].id`\n - `object_nonce_id`: `$.data.videos[N].object_nonce_id`\n - `username` / `nickname` / `title`: `$.data.videos[N].username` etc.\n - Interaction counts: `$.data.videos[N].read_count` / `.like_count` / `.fav_count` / `.forward_count` / `.comment_count`\n - Publish time: `$.data.videos[N].create_time`\n - Location: `$.data.videos[N].location`\n#### `raw=true` (raw):\n- Status code: `$.data.baseResponse.ret`\n- Video array (note: singular **`object`**, camelCase): `$.data.object[N]`\n- Pagination: `$.data.upContinueFlag`, `$.data.lastBuffer` (alias `$.data.last_buffer` also provided)\n- Account profile: `$.data.contact` (nickname/signature/`authInfo` etc.), `$.data.finderUserInfo`\n- Mapping: `videos[]` of raw=false corresponds to `object[]` of raw=true; `nickname` comes from `finderUserInfo` / `contact.nickname`.\n\nAPI references: `fetch_video_comments` = `POST /tikhub/wechat_channels/v2/fetch_video_comments` (operationId: `post_tikhub_wechat_channels_v2_fetch_video_comments`); `fetch_video_detail` = `POST /tikhub/wechat_channels/v2/fetch_video_detail` (operationId: `post_tikhub_wechat_channels_v2_fetch_video_detail`).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "wechat_channels fetch_user_videos", "tags": [ "tikhub.wechat_channels" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "e4855f2cd588" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/wechat_channels/v2/fetch_user_videos", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_wechat_channels_v2_fetch_user_videos", "method": "POST", "path": "/apis/v1/tikhub/wechat_channels/v2/fetch_user_videos" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "username": { "type": "string", "maxLength": 256, "minLength": 10, "pattern": "^v2_[0-9a-fA-F]+@finder$", "title": "Username", "description": "WeChat Channels finder username (`v2_…@finder` format), e.g. `v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder` (People's Daily). See `fetch_channel_info` / `fetch_video_detail` / `fetch_channel_id_to_username` docs for how to obtain it.\n\nAPI references: `fetch_channel_id_to_username` = `POST /tikhub/wechat_channels/v2/fetch_channel_id_to_username` (operationId: `post_tikhub_wechat_channels_v2_fetch_channel_id_to_username`); `fetch_channel_info` = `POST /tikhub/wechat_channels/v2/fetch_channel_info` (operationId: `post_tikhub_wechat_channels_v2_fetch_channel_info`); `fetch_video_detail` = `POST /tikhub/wechat_channels/v2/fetch_video_detail` (operationId: `post_tikhub_wechat_channels_v2_fetch_video_detail`).", "example": "v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder" }, "last_buffer": { "title": "Last Buffer", "description": "Optional pagination cursor (base64). **Leave empty for the first page**; when `up_continue` in the response is truthy, pass the previous page's `last_buffer` to get the next page. (base64 contains `+//=` characters, hence body instead of query.)", "default": "", "type": [ "string", "null" ], "pattern": "^[A-Za-z0-9+/=_-]*$" }, "raw": { "type": "boolean", "title": "Raw", "description": "True=raw response; False=simplified parsed structure (recommended for media download", "default": true } }, "type": "object", "required": [ "username" ], "title": "FetchUserVideosRequest" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:3e8a2b1958c6cde615edb6fd4604f9f983e87dfee36a783e2755b722ea946492" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/wechat_channels/v2/fetch_user_videos \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"username\": \"v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-wechat_channels-v2-fetch_user_videos" } }, "/apis/v1/tikhub/wechat_channels/v2/fetch_video_comments": { "post": { "description": "WeChat Channels (v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get first-level comments of a video (with IP region / like count); pass `comment_id` to get second-level replies under that comment.\n- Supports pagination for more comments.\n\n- ⏱️ Due to WeChat server latency, this endpoint responds slowly; please set your client request timeout to 30 seconds — a timeout that is too small may result in being billed without receiving the response.\n- ⚠️ Large-integer ID precision: IDs such as `comment_id` in the response are 64-bit big integers beyond JavaScript's safe-integer range (2^53-1). Always receive / pass such IDs as **strings** (parse JSON with json-bigint or read them as text), never through JS `Number`. Swagger UI rounds the trailing digits of huge integers in its docs view — this is expected and does not affect the actual data returned by the API.\n\n### Parameters\n- object_id: Video objectId (numeric), e.g. `14941130915890399732`. From the video `id` of `fetch_user_videos` / `fetch_video_detail`.\n- last_buffer: Optional pagination cursor (base64). **Leave empty for the first page**; when `down_continue` is truthy, pass the previous page's `last_buffer`.\n- comment_id: Optional. To expand the replies of a comment, pass its `comment_id` (numeric); leave empty for the first-level page.\n- raw: Optional, default True. True=raw response; False=simplified parsed structure.\n\n### Return\n- Comment list with pagination cursor\n\n### Response structure & JSON Path\n#### `raw=false` (simplified):\n- Top level: `$.data.object_id` (echo) / `$.data.comment_id` (echo when expanding replies, otherwise null) / `$.data.count` (comments on this page) / `$.data.down_continue` (has next page) / `$.data.last_buffer` (pagination cursor)\n- Each comment `$.data.comments[N]`:\n - Comment ID (pass it back to expand its replies): `$.data.comments[N].comment_id`\n - Commenter: `$.data.comments[N].nickname` / `.username` / `.head_url`\n - Content: `$.data.comments[N].content`\n - Like / reply counts: `$.data.comments[N].like_count` / `.reply_count`\n - Time / IP region: `$.data.comments[N].create_time` / `.ip_region`\n#### `raw=true` (raw):\n- Status code: `$.data.baseResponse.ret`\n- Comment array (camelCase): `$.data.commentInfo[N]`, key fields `commentId` / `nickname` / `username` / `content` / `likeCount` / `createtime` / `headUrl` / `ipRegionInfo.regionText`\n- Pagination: `$.data.downContinueFlag`, `$.data.lastBuffer` (alias `$.data.last_buffer` also provided)\n- Global counts: `$.data.monotonicData.commentCount.commentCount`, `$.data.countInfo` (likeCount/favCount/forwardCount etc.)\n- Mapping: `comments[]` of raw=false corresponds to `commentInfo[]` of raw=true.\n\nAPI references: `fetch_user_videos` = `POST /tikhub/wechat_channels/v2/fetch_user_videos` (operationId: `post_tikhub_wechat_channels_v2_fetch_user_videos`); `fetch_video_detail` = `POST /tikhub/wechat_channels/v2/fetch_video_detail` (operationId: `post_tikhub_wechat_channels_v2_fetch_video_detail`).\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_wechat_channels_v2_fetch_video_comments", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Comment list with pagination cursor\n\n### Response structure & JSON Path\n#### `raw=false` (simplified):\n- Top level: `$.data.object_id` (echo) / `$.data.comment_id` (echo when expanding replies, otherwise null) / `$.data.count` (comments on this page) / `$.data.down_continue` (has next page) / `$.data.last_buffer` (pagination cursor)\n- Each comment `$.data.comments[N]`:\n - Comment ID (pass it back to expand its replies): `$.data.comments[N].comment_id`\n - Commenter: `$.data.comments[N].nickname` / `.username` / `.head_url`\n - Content: `$.data.comments[N].content`\n - Like / reply counts: `$.data.comments[N].like_count` / `.reply_count`\n - Time / IP region: `$.data.comments[N].create_time` / `.ip_region`\n#### `raw=true` (raw):\n- Status code: `$.data.baseResponse.ret`\n- Comment array (camelCase): `$.data.commentInfo[N]`, key fields `commentId` / `nickname` / `username` / `content` / `likeCount` / `createtime` / `headUrl` / `ipRegionInfo.regionText`\n- Pagination: `$.data.downContinueFlag`, `$.data.lastBuffer` (alias `$.data.last_buffer` also provided)\n- Global counts: `$.data.monotonicData.commentCount.commentCount`, `$.data.countInfo` (likeCount/favCount/forwardCount etc.)\n- Mapping: `comments[]` of raw=false corresponds to `commentInfo[]` of raw=true.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "wechat_channels fetch_video_comments", "tags": [ "tikhub.wechat_channels" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "af5ec2a1e1e1" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/wechat_channels/v2/fetch_video_comments", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_wechat_channels_v2_fetch_video_comments", "method": "POST", "path": "/apis/v1/tikhub/wechat_channels/v2/fetch_video_comments" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "object_id": { "type": "string", "maxLength": 32, "pattern": "^[0-9]+$", "title": "Object Id", "description": "Video objectId (numeric), e.g. `14941130915890399732`. From the video `id` of `fetch_user_videos` / `fetch_video_detail`.\n\nAPI references: `fetch_user_videos` = `POST /tikhub/wechat_channels/v2/fetch_user_videos` (operationId: `post_tikhub_wechat_channels_v2_fetch_user_videos`); `fetch_video_detail` = `POST /tikhub/wechat_channels/v2/fetch_video_detail` (operationId: `post_tikhub_wechat_channels_v2_fetch_video_detail`).", "example": "14941130915890399732" }, "last_buffer": { "title": "Last Buffer", "description": "Optional pagination cursor (base64). **Leave empty for the first page**; when `down_continue` is truthy, pass the previous page's `last_buffer`.", "default": "", "type": [ "string", "null" ], "pattern": "^[A-Za-z0-9+/=_-]*$" }, "comment_id": { "title": "Comment Id", "description": "Pass a commentId (numeric) to expand its replies, leave empty for first-level comments\n\nUsage: Optional. To expand the replies of a comment, pass its `comment_id` (numeric); leave empty for the first-level page.", "default": "", "type": [ "string", "null" ], "maxLength": 32, "pattern": "^[0-9]*$" }, "raw": { "type": "boolean", "title": "Raw", "description": "True=raw response; False=simplified parsed structure", "default": true } }, "type": "object", "required": [ "object_id" ], "title": "FetchVideoCommentsRequest" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:7393560077872397e0c1e8536081f2d416f34094f588d30606cd75d547feba50" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/wechat_channels/v2/fetch_video_comments \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"object_id\": \"14941130915890399732\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-wechat_channels-v2-fetch_video_comments" } }, "/apis/v1/tikhub/wechat_channels/v2/fetch_video_detail": { "post": { "description": "WeChat Channels (v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get the full detail of a WeChat Channels video (media address `media` + `decode_key`).\n- Three input options, **choose one, priority object_id > export_id > share_url**.\n\n- ⏱️ Due to WeChat server latency, this endpoint responds slowly; please set your client request timeout to 30 seconds — a timeout that is too small may result in being billed without receiving the response.\n- ⚠️ Large-integer ID precision: IDs such as `id` in the response are 64-bit big integers beyond JavaScript's safe-integer range (2^53-1). Always receive / pass such IDs as **strings** (parse JSON with json-bigint or read them as text), never through JS `Number`. Swagger UI rounds the trailing digits of huge integers in its docs view — this is expected and does not affect the actual data returned by the API.\n\n### Parameters\n- object_id: Highest priority, optional. Video objectId (numeric), e.g. `14941130915890399732`. Obtainable from the video `id` of `fetch_user_videos` / `fetch_collection_videos`.\n- export_id: Second priority, optional. `exportId` from search results (must start with `export/`). Search results often only carry `exportId` without a plain object_id — pass export_id directly in that case (it expires, use it soon).\n- object_nonce_id: Optional. `feedNonceId` (numeric) from search results, pairs with the above to improve hit rate.\n- share_url: Last, optional. Channels share URL (`https://weixin.qq.com/sph/…`), e.g. `https://weixin.qq.com/sph/AH3sCoIPhH`. Used only when both object_id and export_id are empty.\n- raw: Optional, default True. True=raw response; False=simplified parsed structure (recommended for media download).\n- At least one of the three must be provided; `share_url` must be a Channels share URL (`https://weixin.qq.com/sph/…`).\n\n### Return\n- Full video detail (including media download address and decryption key)\n\n### Typical chain (from a video to the account / more videos)\n1. This endpoint `fetch_video_detail` → response contains plain `id` (objectId), `username` (`v2_…@finder`), `media` (`url` / `url_token` / `decode_key`)\n2. Feed the obtained `username` into → `fetch_channel_info` (account info / verification), `fetch_user_videos` (more videos of the account), `fetch_user_profile` (homepage stats), `fetch_video_comments` (comments of this video, using `id` from step 1)\n\n### Response structure & JSON Path\n#### `raw=false` (simplified, recommended):\n- `data` is a single video object:\n - `id` (video objectId): `$.data.id`\n - `username` (`v2_…@finder`) / `nickname` / `title`: `$.data.username` etc.\n - Interaction counts: `$.data.read_count` / `.like_count` / `.fav_count` / `.forward_count` / `.comment_count`\n - Publish time / type / location: `$.data.create_time` / `$.data.object_type` / `$.data.location`\n - Media object: `$.data.media` (see download/decryption below)\n#### `raw=true` (raw):\n- Status code: `$.data.baseResponse.ret`\n- Hit receipt: `$.data.objectResponses[0].objectId` / `.exportId`\n- Video object (**note: plural `objects`**, camelCase): `$.data.objects[0]`\n- Mapping: flat fields of raw=false correspond to `objects[0]` of raw=true.\n\n### Important Note (video download & decryption)\n- Accessing the `url` field directly may fail to open the video page — WeChat applies **anti-hotlinking** to Channels pages. Concatenate `url` and `url_token` into a complete URL, then open it in a browser / HTTP client. (Note: opening = HTTP 200, **does not mean playable**, the video file is encrypted.)\n- ⚠️ **Video Encryption Notice**: If the MP4 cannot be played, it is encrypted. Use the `decode_key` field from the response together with the encrypted video file to decrypt it.\n- ⚠️ **Important**: The WeChat API returns a **new encrypted file link and `decode_key` on every request**, even for the same video. Make sure the `decode_key` used for decryption and the downloaded encrypted file come from the **same API response**, otherwise decryption will fail.\n- JSON Path (by raw):\n - `raw=false` (recommended for media download) — `$.data.media` is a single object:\n - Video CDN link (without Token): `$.data.media.url`\n - Token of the video CDN link: `$.data.media.url_token`\n - Pre-concatenated full CDN URL (= `url` + `url_token`, ready to use): `$.data.media.full_url`\n - Video decryption key (different on every request): `$.data.media.decode_key`\n - `raw=true` — `$.data.objects[0].objectDesc.media[0]`:\n - Video CDN link (without Token): `$.data.objects[0].objectDesc.media[0].url`\n - Token: `$.data.objects[0].objectDesc.media[0].urlToken`\n - Full URL = `url` + `urlToken` (concatenate)\n - Video decryption key: `$.data.objects[0].objectDesc.media[0].decodeKey`\n- Online decryption tool: https://evil0ctal.github.io/WeChat-Channels-Video-File-Decryption/\n- Self-deployable decryption API (one-click Docker deployment): https://github.com/Evil0ctal/WeChat-Channels-Video-File-Decryption\n\nAPI references: `fetch_channel_info` = `POST /tikhub/wechat_channels/v2/fetch_channel_info` (operationId: `post_tikhub_wechat_channels_v2_fetch_channel_info`); `fetch_collection_videos` = `POST /tikhub/wechat_channels/v2/fetch_collection_videos` (operationId: `post_tikhub_wechat_channels_v2_fetch_collection_videos`); `fetch_user_profile` = `POST /tikhub/wechat_channels/v2/fetch_user_profile` (operationId: `post_tikhub_wechat_channels_v2_fetch_user_profile`); `fetch_user_videos` = `POST /tikhub/wechat_channels/v2/fetch_user_videos` (operationId: `post_tikhub_wechat_channels_v2_fetch_user_videos`); `fetch_video_comments` = `POST /tikhub/wechat_channels/v2/fetch_video_comments` (operationId: `post_tikhub_wechat_channels_v2_fetch_video_comments`).\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_wechat_channels_v2_fetch_video_detail", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Full video detail (including media download address and decryption key)\n\n### Response structure & JSON Path\n#### `raw=false` (simplified, recommended):\n- `data` is a single video object:\n - `id` (video objectId): `$.data.id`\n - `username` (`v2_…@finder`) / `nickname` / `title`: `$.data.username` etc.\n - Interaction counts: `$.data.read_count` / `.like_count` / `.fav_count` / `.forward_count` / `.comment_count`\n - Publish time / type / location: `$.data.create_time` / `$.data.object_type` / `$.data.location`\n - Media object: `$.data.media` (see download/decryption below)\n#### `raw=true` (raw):\n- Status code: `$.data.baseResponse.ret`\n- Hit receipt: `$.data.objectResponses[0].objectId` / `.exportId`\n- Video object (**note: plural `objects`**, camelCase): `$.data.objects[0]`\n- Mapping: flat fields of raw=false correspond to `objects[0]` of raw=true.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "wechat_channels fetch_video_detail", "tags": [ "tikhub.wechat_channels" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "c6d83b0d9c84" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/wechat_channels/v2/fetch_video_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_wechat_channels_v2_fetch_video_detail", "method": "POST", "path": "/apis/v1/tikhub/wechat_channels/v2/fetch_video_detail" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "object_id": { "title": "Object Id", "description": "Highest priority, optional. Video objectId (numeric), e.g. `14941130915890399732`. Obtainable from the video `id` of `fetch_user_videos` / `fetch_collection_videos`.\n\nAPI references: `fetch_collection_videos` = `POST /tikhub/wechat_channels/v2/fetch_collection_videos` (operationId: `post_tikhub_wechat_channels_v2_fetch_collection_videos`); `fetch_user_videos` = `POST /tikhub/wechat_channels/v2/fetch_user_videos` (operationId: `post_tikhub_wechat_channels_v2_fetch_user_videos`).", "default": "", "example": "14941130915890399732", "type": [ "string", "null" ], "maxLength": 32, "pattern": "^[0-9]*$" }, "export_id": { "title": "Export Id", "description": "Second priority, optional. `exportId` from search results (must start with `export/`). Search results often only carry `exportId` without a plain object_id — pass export_id directly in that case (it expires, use it soon).", "default": "", "type": [ "string", "null" ], "maxLength": 2048, "pattern": "^(export/.+)?$" }, "object_nonce_id": { "title": "Object Nonce Id", "description": "Optional objectNonceId (numeric, improves hit rate\n\nUsage: Optional. `feedNonceId` (numeric) from search results, pairs with the above to improve hit rate.", "default": "", "type": [ "string", "null" ], "maxLength": 32, "pattern": "^[0-9]*$" }, "share_url": { "title": "Share Url", "description": "Last, optional. Channels share URL (`https://weixin.qq.com/sph/…`), e.g. `https://weixin.qq.com/sph/AH3sCoIPhH`. Used only when both object_id and export_id are empty.", "default": "", "type": [ "string", "null" ], "maxLength": 256, "pattern": "^(https?://weixin\\.qq\\.com/sph/[A-Za-z0-9]+/?)?$" }, "raw": { "type": "boolean", "title": "Raw", "description": "True=raw response; False=simplified parsed structure (recommended for media download", "default": true } }, "type": "object", "title": "FetchVideoDetailRequest" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:dbbea6315e455927414434563728eb3b1bd9a0fbce49bf1ec627b49e1b3bb17d" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-wechat_channels-v2-fetch_video_detail" } }, "/apis/v1/tikhub/wechat_channels/v2/fetch_video_share_url": { "post": { "description": "WeChat Channels (v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Given a video `object_id`, return a shareable `weixin.qq.com/sph/…` short link (the inverse of the `share_url` input of `fetch_video_detail`).\n\n- ⏱️ Due to WeChat server latency, this endpoint responds slowly; please set your client request timeout to 30 seconds — a timeout that is too small may result in being billed without receiving the response.\n\n### Parameters\n- object_id: Video objectId (numeric), e.g. `14941130915890399732`. From the video `id` of `fetch_user_videos` / `fetch_video_detail`.\n- raw: Optional, default True. True=raw response; False=simplified parsed structure.\n\n### Return\n- Video share short link\n\n### Response structure & JSON Path\n#### `raw=false` (simplified):\n- Input echo: `$.data.object_id`\n- Generated share link (feed directly into `share_url` of `fetch_video_detail`): `$.data.share_url`\n#### `raw=true` (raw):\n- Status code: `$.data.baseResponse.ret`\n- Share link: `$.data.feedH5Url`\n- List form (per item when batched): `$.data.urlList[N].feedH5Url` / `$.data.urlList[N].objectId`\n- Mapping: `share_url` of raw=false comes from `feedH5Url` (or `urlList[0].feedH5Url`) of raw=true; `object_id` is the input echo.\n\nAPI references: `fetch_user_videos` = `POST /tikhub/wechat_channels/v2/fetch_user_videos` (operationId: `post_tikhub_wechat_channels_v2_fetch_user_videos`); `fetch_video_detail` = `POST /tikhub/wechat_channels/v2/fetch_video_detail` (operationId: `post_tikhub_wechat_channels_v2_fetch_video_detail`).\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_wechat_channels_v2_fetch_video_share_url", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Video share short link\n\n### Response structure & JSON Path\n#### `raw=false` (simplified):\n- Input echo: `$.data.object_id`\n- Generated share link (feed directly into `share_url` of `fetch_video_detail`): `$.data.share_url`\n#### `raw=true` (raw):\n- Status code: `$.data.baseResponse.ret`\n- Share link: `$.data.feedH5Url`\n- List form (per item when batched): `$.data.urlList[N].feedH5Url` / `$.data.urlList[N].objectId`\n- Mapping: `share_url` of raw=false comes from `feedH5Url` (or `urlList[0].feedH5Url`) of raw=true; `object_id` is the input echo.\n\nAPI references: `fetch_video_detail` = `POST /tikhub/wechat_channels/v2/fetch_video_detail` (operationId: `post_tikhub_wechat_channels_v2_fetch_video_detail`).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "wechat_channels fetch_video_share_url", "tags": [ "tikhub.wechat_channels" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a44bf4899472" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/wechat_channels/v2/fetch_video_share_url", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_wechat_channels_v2_fetch_video_share_url", "method": "POST", "path": "/apis/v1/tikhub/wechat_channels/v2/fetch_video_share_url" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "object_id": { "type": "string", "maxLength": 32, "pattern": "^[0-9]+$", "title": "Object Id", "description": "Video objectId (numeric), e.g. `14941130915890399732`. From the video `id` of `fetch_user_videos` / `fetch_video_detail`.\n\nAPI references: `fetch_user_videos` = `POST /tikhub/wechat_channels/v2/fetch_user_videos` (operationId: `post_tikhub_wechat_channels_v2_fetch_user_videos`); `fetch_video_detail` = `POST /tikhub/wechat_channels/v2/fetch_video_detail` (operationId: `post_tikhub_wechat_channels_v2_fetch_video_detail`).", "example": "14941130915890399732" }, "raw": { "type": "boolean", "title": "Raw", "description": "True=raw response; False=simplified parsed structure", "default": true } }, "type": "object", "required": [ "object_id" ], "title": "FetchVideoShareUrlRequest" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:477cf1c762ac84023f62a294069ca04c0921ad687a35bbcda98421d13aaca53a" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/wechat_channels/v2/fetch_video_share_url \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"object_id\": \"14941130915890399732\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-wechat_channels-v2-fetch_video_share_url" } }, "/apis/v1/tikhub/wechat_mp/v2/fetch_account_articles": { "post": { "description": "WeChat Official Accounts (v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Pass a `gh_username` to get a **single page** of the account's historical posts (**article** tab).\n- **Manual paging**: leave `offset` empty for the first page → take `next_offset` (base64 cursor) from the response → pass it as **`offset`** in the next request; `is_end` truthy means the last page.\n\n- ⏱️ Due to WeChat server latency, this endpoint responds slowly; please set your client request timeout to 30 seconds — a timeout that is too small may result in being billed without receiving the response.\n\n### Parameters\n- username: Official account `gh_username` (`gh_…`). E.g. `gh_363b924965e9`\n- page_size: Optional, default 20. NOTE: WeChat currently **ignores** this parameter — the count is decided by the account itself (1 and 40 return identically). Paginate with `offset` / `next_offset`.\n- offset: Optional pagination cursor (base64), **leave empty for the first page**; for the next page pass `next_offset` from the previous response. E.g. `CAMQChiS5KfRBiAKOJLkp9EGQABIAVgAYABwAQ==`\n- item_show_type: Optional content tab (matches the \"Articles / Videos / Audios\" tabs on the account homepage). Empty / `0`=articles (default), `5`=videos, `7`=audios, `8`=image-text posts. Omitting it = articles, behavior unchanged.\n- raw: Optional, default True. True=raw; False=simplified parsing.\n\n### Return\n- Single page of articles with pagination cursor\n\n> Tip: `offset` is a base64 cursor (contains `+/=`), hence POST body. This endpoint **fetches a single page only and does not auto-paginate**.\n\n### Response structure & JSON Path\n#### `raw=false` (simplified, snake_case):\n- Account username: `$.data.biz_username`\n- Is last page (0/1): `$.data.is_end`\n- Articles returned on this page: `$.data.count`\n- Next-page cursor (pass back as `offset`; null at the last page): `$.data.next_offset`\n- Article list: `$.data.articles[]`\n- Single article (N is the index):\n - Article appmsgid: `$.data.articles[N].app_msg_id`\n - Title: `$.data.articles[N].title`\n - Digest: `$.data.articles[N].digest`\n - URL: `$.data.articles[N].url`\n - Cover: `$.data.articles[N].cover` (multi-ratio `$.data.articles[N].covers`)\n - Publish / update timestamps: `$.data.articles[N].create_time` / `.update_time`\n - Position / type within the batch: `$.data.articles[N].idx` / `.msg_type` / `.item_show_type`\n - Image count / paid flags: `$.data.articles[N].pic_count` / `.is_paid` / `.is_pay_subscribe`\n#### `raw=true` (raw, default for this endpoint):\n- `data` top-level fields match the simplified version (`biz_username` / `is_end` / `count` / `next_offset`), but `articles[]` are full raw batch entries (nested camelCase):\n - Per entry: `$.data.articles[N].appMsg` (with `baseInfo` / `detailInfo`), `$.data.articles[N].baseInfo` (`msgId` / `msgType` / `dateTime` / `status`)\n - Article bodies are in `$.data.articles[N].appMsg.detailInfo` (one batch may contain multiple articles: headline / secondary)\n - Pagination also uses top-level `next_offset` passed back as `offset`. For list display, prefer `raw=false` for cleaner paths.\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_wechat_mp_v2_fetch_account_articles", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Single page of articles with pagination cursor\n\n> Tip: `offset` is a base64 cursor (contains `+/=`), hence POST body. This endpoint **fetches a single page only and does not auto-paginate**.\n\n### Response structure & JSON Path\n#### `raw=false` (simplified, snake_case):\n- Account username: `$.data.biz_username`\n- Is last page (0/1): `$.data.is_end`\n- Articles returned on this page: `$.data.count`\n- Next-page cursor (pass back as `offset`; null at the last page): `$.data.next_offset`\n- Article list: `$.data.articles[]`\n- Single article (N is the index):\n - Article appmsgid: `$.data.articles[N].app_msg_id`\n - Title: `$.data.articles[N].title`\n - Digest: `$.data.articles[N].digest`\n - URL: `$.data.articles[N].url`\n - Cover: `$.data.articles[N].cover` (multi-ratio `$.data.articles[N].covers`)\n - Publish / update timestamps: `$.data.articles[N].create_time` / `.update_time`\n - Position / type within the batch: `$.data.articles[N].idx` / `.msg_type` / `.item_show_type`\n - Image count / paid flags: `$.data.articles[N].pic_count` / `.is_paid` / `.is_pay_subscribe`\n#### `raw=true` (raw, default for this endpoint):\n- `data` top-level fields match the simplified version (`biz_username` / `is_end` / `count` / `next_offset`), but `articles[]` are full raw batch entries (nested camelCase):\n - Per entry: `$.data.articles[N].appMsg` (with `baseInfo` / `detailInfo`), `$.data.articles[N].baseInfo` (`msgId` / `msgType` / `dateTime` / `status`)\n - Article bodies are in `$.data.articles[N].appMsg.detailInfo` (one batch may contain multiple articles: headline / secondary)\n - Pagination also uses top-level `next_offset` passed back as `offset`. For list display, prefer `raw=false` for cleaner paths.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "wechat_mp fetch_account_articles", "tags": [ "tikhub.wechat_mp" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "138a97ce7c78" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/wechat_mp/v2/fetch_account_articles", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_wechat_mp_v2_fetch_account_articles", "method": "POST", "path": "/apis/v1/tikhub/wechat_mp/v2/fetch_account_articles" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "username": { "type": "string", "maxLength": 80, "pattern": "^[0-9A-Za-z][-_0-9A-Za-z]{1,63}(@[0-9A-Za-z]{1,16})?$", "title": "Username", "description": "Official account username. Three forms are supported: `gh_…`, `gh_…@app` (mini-program-linked accounts) and custom WeChat IDs (e.g. `nikejdi`). Taken from `$.data.content.user_name` of the article detail endpoints\n\nUsage: Official account `gh_username` (`gh_…`). E.g. `gh_363b924965e9`", "example": "gh_363b924965e9" }, "page_size": { "type": "integer", "maximum": 100.0, "minimum": 1.0, "title": "Page Size", "description": "Articles per page (default 20). WeChat currently ignores this parameter; the account determines the returned count. Paginate using offset and next_offset.", "default": 20 }, "offset": { "title": "Offset", "description": "Optional pagination cursor (base64), **leave empty for the first page**; for the next page pass `next_offset` from the previous response. E.g. `CAMQChiS5KfRBiAKOJLkp9EGQABIAVgAYABwAQ==`", "default": "", "type": [ "string", "null" ], "maxLength": 8192, "pattern": "^[A-Za-z0-9+/=_-]*$" }, "item_show_type": { "title": "Item Show Type", "description": "Optional content tab (matches the \"Articles / Videos / Audios\" tabs on the account homepage). Empty / `0`=articles (default), `5`=videos, `7`=audios, `8`=image-text posts. Omitting it = articles, behavior unchanged.", "type": [ "integer", "null" ] }, "raw": { "type": "boolean", "title": "Raw", "description": "True=raw response; False=simplified parsed structure", "default": true } }, "type": "object", "required": [ "username" ], "title": "FetchAccountArticlesRequest" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:267f4a2b90c5eefab38f97338c1cf083555f5eb24c5167921c7d864831016017" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/wechat_mp/v2/fetch_account_articles \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"username\": \"gh_363b924965e9\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-wechat_mp-v2-fetch_account_articles" } }, "/apis/v1/tikhub/wechat_mp/v2/fetch_account_profile": { "post": { "description": "WeChat Official Accounts (v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Pass an account username to get the profile: nickname / IP region / original article count / verification entity type / linked Channels account, etc.\n- NOTE: **signature and avatar are not obtainable through this path** — WeChat's profile response carries neither. They are always `null` and listed in `$.data.unavailable[]` (never faked as empty strings).\n- For the **avatar**, use `/tikhub/wechat_mp/v2/fetch_article_detail_h5` instead (pass any article URL of that account with `raw=true`): `$.data.content.round_head_img` / `$.data.content.hd_head_img`. No endpoint currently exposes the signature.\n- Some accounts (like the example) have sparse fields; `nick_name` / `signature` / `head_url` may be `null`.\n\n- ⏱️ Due to WeChat server latency, this endpoint responds slowly; please set your client request timeout to 30 seconds — a timeout that is too small may result in being billed without receiving the response.\n\n### Parameters\n- username: Official account `gh_username` (`gh_…`). Sources: `content.user_name` from article detail, or `jumpInfo.userName` from WeChat Search V2 `fetch_search` (business_type=account) results. E.g. `gh_363b924965e9`\n- raw: Optional, default True. True=raw; False=simplified parsing.\n\n### Return\n- Official account profile info\n\n### Response structure & JSON Path\n#### `raw=false` (simplified, snake_case):\n- Account username (`gh_…`): `$.data.user_name`\n- Nickname (may be null): `$.data.nick_name`\n- User role: `$.data.user_role`\n- Service type (subscription / service account code): `$.data.service_type`\n- Signature / description (may be null): `$.data.signature`\n- Avatar (may be null): `$.data.head_url`\n- Ban type (0=normal): `$.data.ban_type`\n#### `raw=true` (raw, default for this endpoint):\n- `data` is the full raw response (dozens of top-level fields); simplified fields map to nested locations:\n - Base info block: `$.data.baseInfo` (raw source of nickname / avatar / description)\n - Account info: `$.data.accountInfo` (with `userName` etc.)\n - Stats info: `$.data.statInfo`\n - Linked Channels account: `$.data.videoFinderInfo`\n - Service info (raw source of custom menu): `$.data.serviceInfo`\n - Article tab / message list: `$.data.articleTab` / `$.data.msgList`\n - IP region: `$.data.ipwording`\n - Others: `liveInfo` / `nameCard` / `gender` / `setting` / `funcFlag` etc.\n\nAPI references: `fetch_article_detail_h5` = `POST /tikhub/wechat_mp/v2/fetch_article_detail_h5` (operationId: `post_tikhub_wechat_mp_v2_fetch_article_detail_h5`); `fetch_search` = `POST /tikhub/wechat_search/v2/fetch_search` (operationId: `post_tikhub_wechat_search_v2_fetch_search`).\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_wechat_mp_v2_fetch_account_profile", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Official account profile info\n\n### Response structure & JSON Path\n#### `raw=false` (simplified, snake_case):\n- Account username (`gh_…`): `$.data.user_name`\n- Nickname (may be null): `$.data.nick_name`\n- User role: `$.data.user_role`\n- Service type (subscription / service account code): `$.data.service_type`\n- Signature / description (may be null): `$.data.signature`\n- Avatar (may be null): `$.data.head_url`\n- Ban type (0=normal): `$.data.ban_type`\n#### `raw=true` (raw, default for this endpoint):\n- `data` is the full raw response (dozens of top-level fields); simplified fields map to nested locations:\n - Base info block: `$.data.baseInfo` (raw source of nickname / avatar / description)\n - Account info: `$.data.accountInfo` (with `userName` etc.)\n - Stats info: `$.data.statInfo`\n - Linked Channels account: `$.data.videoFinderInfo`\n - Service info (raw source of custom menu): `$.data.serviceInfo`\n - Article tab / message list: `$.data.articleTab` / `$.data.msgList`\n - IP region: `$.data.ipwording`\n - Others: `liveInfo` / `nameCard` / `gender` / `setting` / `funcFlag` etc.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "wechat_mp fetch_account_profile", "tags": [ "tikhub.wechat_mp" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a9633d2b8408" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/wechat_mp/v2/fetch_account_profile", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_wechat_mp_v2_fetch_account_profile", "method": "POST", "path": "/apis/v1/tikhub/wechat_mp/v2/fetch_account_profile" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "username": { "type": "string", "maxLength": 80, "pattern": "^[0-9A-Za-z][-_0-9A-Za-z]{1,63}(@[0-9A-Za-z]{1,16})?$", "title": "Username", "description": "Official account username. Three forms are supported: `gh_…`, `gh_…@app` (mini-program-linked accounts) and custom WeChat IDs (e.g. `nikejdi`). Taken from `$.data.content.user_name` of the article detail endpoints", "example": "gh_363b924965e9" }, "raw": { "type": "boolean", "title": "Raw", "description": "True=raw response; False=simplified parsed structure", "default": true } }, "type": "object", "required": [ "username" ], "title": "FetchAccountRequest" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:73b4a455cbe7edee947bbd71be0b3d77c6e553e0f4fb4060829ade7c0a6bc853" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/wechat_mp/v2/fetch_account_profile \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"username\": \"gh_363b924965e9\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-wechat_mp-v2-fetch_account_profile" } }, "/apis/v1/tikhub/wechat_mp/v2/fetch_account_services": { "post": { "description": "WeChat Official Accounts (v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Pass a `gh_username` to get the custom menu / service entries at the bottom of the official account. Accounts without a custom menu return an empty menu.\n\n- ⏱️ Due to WeChat server latency, this endpoint responds slowly; please set your client request timeout to 30 seconds — a timeout that is too small may result in being billed without receiving the response.\n\n### Parameters\n- username: Official account `gh_username` (`gh_…`). E.g. `gh_363b924965e9`\n- raw: Optional, default True. True=raw; False=simplified parsing.\n\n### Return\n- Custom menu / service entries of the official account\n\n### Response structure & JSON Path\n#### `raw=false` (simplified, snake_case):\n- Account username: `$.data.biz_username`\n- Menu item list (`[]` when no menu): `$.data.menu[]` — each item is a menu button (name / type / sub-menu / jump); the array is empty for accounts without a custom menu.\n#### `raw=true` (raw, default for this endpoint):\n- `data` is the full raw menu structure. Accounts without a configured menu return an empty object `{}`.\n- The simplified `menu[]` is extracted from this raw structure.\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_wechat_mp_v2_fetch_account_services", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Custom menu / service entries of the official account\n\n### Response structure & JSON Path\n#### `raw=false` (simplified, snake_case):\n- Account username: `$.data.biz_username`\n- Menu item list (`[]` when no menu): `$.data.menu[]` — each item is a menu button (name / type / sub-menu / jump); the array is empty for accounts without a custom menu.\n#### `raw=true` (raw, default for this endpoint):\n- `data` is the full raw menu structure. Accounts without a configured menu return an empty object `{}`.\n- The simplified `menu[]` is extracted from this raw structure.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "wechat_mp fetch_account_services", "tags": [ "tikhub.wechat_mp" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "69400cabaf3d" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/wechat_mp/v2/fetch_account_services", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_wechat_mp_v2_fetch_account_services", "method": "POST", "path": "/apis/v1/tikhub/wechat_mp/v2/fetch_account_services" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "username": { "type": "string", "maxLength": 80, "pattern": "^[0-9A-Za-z][-_0-9A-Za-z]{1,63}(@[0-9A-Za-z]{1,16})?$", "title": "Username", "description": "Official account username. Three forms are supported: `gh_…`, `gh_…@app` (mini-program-linked accounts) and custom WeChat IDs (e.g. `nikejdi`). Taken from `$.data.content.user_name` of the article detail endpoints", "example": "gh_363b924965e9" }, "raw": { "type": "boolean", "title": "Raw", "description": "True=raw response; False=simplified parsed structure", "default": true } }, "type": "object", "required": [ "username" ], "title": "FetchAccountRequest" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:5207cdbf71678e66ecd4e6575bfaeef0c0a3145c62f71d516498c030445dc106" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/wechat_mp/v2/fetch_account_services \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"username\": \"gh_363b924965e9\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-wechat_mp-v2-fetch_account_services" } }, "/apis/v1/tikhub/wechat_mp/v2/fetch_article_ad": { "post": { "description": "WeChat Official Accounts (v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Pass an article URL to get the embedded ad slot info of the article. This endpoint responds relatively slowly, please be patient; articles without ads return empty.\n\n- ⏱️ Due to WeChat server latency, this endpoint responds slowly; please set your client request timeout to 30 seconds — a timeout that is too small may result in being billed without receiving the response.\n\n### Parameters\n- url: WeChat MP article URL. E.g. `https://mp.weixin.qq.com/s/TSNQKkRpN1qbKsT7BvzqIw` (this article has no ads, returns empty)\n- raw: Optional, default True. True=full raw response; False=flattened ad list.\n\n### Return\n- Article ad slot info\n\n### Response structure & JSON Path\n#### `raw=false` (simplified projection):\n- `data` is the flattened ad list:\n - `$.data.count`: number of ads (merged from `advertisement_info` and `ad_slot_data`)\n - `$.data.ads[]`: ad item list (`[]` when no ads)\n#### `raw=true` (raw):\n- `data` is aggregated by the responses captured:\n - `$.data.pages`: number of response pages\n - `$.data.results[]`: full raw response per page (raw ad fields are inside `advertisement_info` / `ad_slot_data` of each page — the source of `ads` in simplified mode)\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_wechat_mp_v2_fetch_article_ad", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Article ad slot info\n\n### Response structure & JSON Path\n#### `raw=false` (simplified projection):\n- `data` is the flattened ad list:\n - `$.data.count`: number of ads (merged from `advertisement_info` and `ad_slot_data`)\n - `$.data.ads[]`: ad item list (`[]` when no ads)\n#### `raw=true` (raw):\n- `data` is aggregated by the responses captured:\n - `$.data.pages`: number of response pages\n - `$.data.results[]`: full raw response per page (raw ad fields are inside `advertisement_info` / `ad_slot_data` of each page — the source of `ads` in simplified mode)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "wechat_mp fetch_article_ad", "tags": [ "tikhub.wechat_mp" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a610652c4c71" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/wechat_mp/v2/fetch_article_ad", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_wechat_mp_v2_fetch_article_ad", "method": "POST", "path": "/apis/v1/tikhub/wechat_mp/v2/fetch_article_ad" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "url": { "type": "string", "maxLength": 2048, "pattern": "^https?://mp\\.weixin\\.qq\\.com/s([/?].+)?$", "title": "Url", "description": "… or long URL with __biz", "example": "https://mp.weixin.qq.com/s/TSNQKkRpN1qbKsT7BvzqIw" }, "raw": { "type": "boolean", "title": "Raw", "description": "True=raw response; False=simplified parsed structure", "default": true } }, "type": "object", "required": [ "url" ], "title": "FetchArticleDetailRequest" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:9e98a176d85716420bdb7ff68300182841f2e630c40d4d30866a205ff3f07a78" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/wechat_mp/v2/fetch_article_ad \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"url\": \"https://mp.weixin.qq.com/s/TSNQKkRpN1qbKsT7BvzqIw\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-wechat_mp-v2-fetch_article_ad" } }, "/apis/v1/tikhub/wechat_mp/v2/fetch_article_comments": { "post": { "description": "WeChat Official Accounts (v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get WeChat MP article comments (single page, `buffer` cursor pagination); returns one page of featured comments.\n- **Pagination**: leave `buffer` empty for the first page → take `buffer` from the response → pass it back in the next request; `has_more` false means the last page.\n- For second-level replies of a specific comment, use `fetch_comment_replies` (pass the comment's `content_id`).\n\n- ⏱️ Due to WeChat server latency, this endpoint responds slowly; please set your client request timeout to 30 seconds — a timeout that is too small may result in being billed without receiving the response.\n- ⚠️ Large-integer ID precision: IDs such as `content_id` in the response are 64-bit big integers beyond JavaScript's safe-integer range (2^53-1). Always receive / pass such IDs as **strings** (parse JSON with json-bigint or read them as text), never through JS `Number`. Swagger UI rounds the trailing digits of huge integers in its docs view — this is expected and does not affect the actual data returned by the API.\n\n### Parameters\n- url: WeChat MP article URL (`https://mp.weixin.qq.com/s/…`). E.g. `https://mp.weixin.qq.com/s/TSNQKkRpN1qbKsT7BvzqIw`\n- buffer: Optional, default empty. Pagination cursor; leave empty for the first page, pass `buffer` from the previous response for the next page.\n- raw: Optional, default True. True=full raw comment objects; False=simplified comment view.\n\n### Return\n- One page of comments with pagination cursor\n\n### Response structure & JSON Path\n#### `raw=false` (simplified view):\n- `data` outer level is the page summary; `comments[]` are simplified comments:\n - `$.data.appmsgid`: message id\n - `$.data.elected_total`: total featured comments\n - `$.data.total_count`: total comments\n - `$.data.buffer`: next-page cursor (pass back as `buffer`; empty string at the last page)\n - `$.data.has_more`: whether there is a next page\n - `$.data.comment_id`: article comment identifier (internal)\n - `$.data.comments[N].content_id`: comment id (**feed into `content_id` of `fetch_comment_replies`**)\n - `$.data.comments[N].nick_name`: commenter nickname\n - `$.data.comments[N].content`: comment content\n - `$.data.comments[N].like_num`: like count\n - `$.data.comments[N].create_time`: comment timestamp\n - `$.data.comments[N].ip_wording`: IP region (`province_name` / `city_name` etc.)\n - `$.data.comments[N].is_elected` / `is_top`: featured / pinned flags\n - `$.data.comments[N].reply_total`: total second-level replies\n - `$.data.comments[N].replies[]`: reply preview (simplified, see `fetch_comment_replies`)\n#### `raw=true` (raw):\n- `data` outer level same as above (`appmsgid` / `elected_total` / `total_count` / `buffer` / `has_more` / `comment_id`); `comments[]` are full raw comment objects with more fields (snake_case):\n - `$.data.comments[N].content_id`: comment id (same as simplified mode, still the value fed into `fetch_comment_replies`)\n - `$.data.comments[N].content` / `nick_name` / `like_num` / `create_time` / `ip_wording` / `is_elected` / `is_top`: same names and meanings as `raw=false`\n - Raw-only extra fields: `$.data.comments[N].id` (floor number) / `openid` / `identity_type` / `logo_url` (avatar) / `like_status` / `is_from_me` / `$.data.comments[N].reply_new` (with `reply_total_cnt` / `reply_list`, corresponding to `reply_total` / `replies` of the simplified mode)\n\nAPI references: `fetch_comment_replies` = `POST /tikhub/wechat_mp/v2/fetch_comment_replies` (operationId: `post_tikhub_wechat_mp_v2_fetch_comment_replies`).\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_wechat_mp_v2_fetch_article_comments", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- One page of comments with pagination cursor\n\n### Response structure & JSON Path\n#### `raw=false` (simplified view):\n- `data` outer level is the page summary; `comments[]` are simplified comments:\n - `$.data.appmsgid`: message id\n - `$.data.elected_total`: total featured comments\n - `$.data.total_count`: total comments\n - `$.data.buffer`: next-page cursor (pass back as `buffer`; empty string at the last page)\n - `$.data.has_more`: whether there is a next page\n - `$.data.comment_id`: article comment identifier (internal)\n - `$.data.comments[N].content_id`: comment id (**feed into `content_id` of `fetch_comment_replies`**)\n - `$.data.comments[N].nick_name`: commenter nickname\n - `$.data.comments[N].content`: comment content\n - `$.data.comments[N].like_num`: like count\n - `$.data.comments[N].create_time`: comment timestamp\n - `$.data.comments[N].ip_wording`: IP region (`province_name` / `city_name` etc.)\n - `$.data.comments[N].is_elected` / `is_top`: featured / pinned flags\n - `$.data.comments[N].reply_total`: total second-level replies\n - `$.data.comments[N].replies[]`: reply preview (simplified, see `fetch_comment_replies`)\n#### `raw=true` (raw):\n- `data` outer level same as above (`appmsgid` / `elected_total` / `total_count` / `buffer` / `has_more` / `comment_id`); `comments[]` are full raw comment objects with more fields (snake_case):\n - `$.data.comments[N].content_id`: comment id (same as simplified mode, still the value fed into `fetch_comment_replies`)\n - `$.data.comments[N].content` / `nick_name` / `like_num` / `create_time` / `ip_wording` / `is_elected` / `is_top`: same names and meanings as `raw=false`\n - Raw-only extra fields: `$.data.comments[N].id` (floor number) / `openid` / `identity_type` / `logo_url` (avatar) / `like_status` / `is_from_me` / `$.data.comments[N].reply_new` (with `reply_total_cnt` / `reply_list`, corresponding to `reply_total` / `replies` of the simplified mode)\n\nAPI references: `fetch_comment_replies` = `POST /tikhub/wechat_mp/v2/fetch_comment_replies` (operationId: `post_tikhub_wechat_mp_v2_fetch_comment_replies`).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "wechat_mp fetch_article_comments", "tags": [ "tikhub.wechat_mp" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a526ff28639a" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/wechat_mp/v2/fetch_article_comments", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_wechat_mp_v2_fetch_article_comments", "method": "POST", "path": "/apis/v1/tikhub/wechat_mp/v2/fetch_article_comments" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "url": { "type": "string", "maxLength": 2048, "pattern": "^https?://mp\\.weixin\\.qq\\.com/s([/?].+)?$", "title": "Url", "description": "WeChat MP article URL (`https://mp.weixin.qq.com/s/…`). E.g. `https://mp.weixin.qq.com/s/TSNQKkRpN1qbKsT7BvzqIw`", "example": "https://mp.weixin.qq.com/s/TSNQKkRpN1qbKsT7BvzqIw" }, "buffer": { "title": "Buffer", "description": "Optional, default empty. Pagination cursor; leave empty for the first page, pass `buffer` from the previous response for the next page.", "default": "", "type": [ "string", "null" ], "maxLength": 8192 }, "comment_id": { "title": "Comment Id", "description": "Article comment id (optional, performance shortcut): when omitted, upstream must fetch and parse the whole article HTML to obtain it, which accounts for about half of this endpoint's latency", "type": [ "string", "null" ], "maxLength": 32, "pattern": "^[0-9]*$" }, "raw": { "type": "boolean", "title": "Raw", "description": "True=raw response; False=simplified parsed structure", "default": true } }, "type": "object", "required": [ "url" ], "title": "FetchArticleCommentsRequest" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:31b1d0b6d3a3e2317c09e284262599e581500ef3ddd6d62fcbe85fd18c5afbdd" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/wechat_mp/v2/fetch_article_comments \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"url\": \"https://mp.weixin.qq.com/s/TSNQKkRpN1qbKsT7BvzqIw\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-wechat_mp-v2-fetch_article_comments" } }, "/apis/v1/tikhub/wechat_mp/v2/fetch_article_detail": { "post": { "description": "WeChat Official Accounts (v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Pass an article URL to get the article body / title / author / cover / publish time / album info.\n- Regardless of `raw`, the nested `content` JSON string is always parsed into an object (structure normalized); `raw` only controls the projection scope of outer fields.\n\n- ⏱️ Due to WeChat server latency, this endpoint responds slowly; please set your client request timeout to 30 seconds — a timeout that is too small may result in being billed without receiving the response.\n- ⚠️ Large-integer ID precision: IDs such as `comment_id` / `msgId` in the response are 64-bit big integers beyond JavaScript's safe-integer range (2^53-1). Always receive / pass such IDs as **strings** (parse JSON with json-bigint or read them as text), never through JS `Number`. Swagger UI rounds the trailing digits of huge integers in its docs view — this is expected and does not affect the actual data returned by the API.\n\n### Parameters\n- url: WeChat MP article URL (`https://mp.weixin.qq.com/s/…` or long URL with `__biz`). E.g. `https://mp.weixin.qq.com/s/TSNQKkRpN1qbKsT7BvzqIw`\n- raw: Optional, default True. True=raw response; False=simplified projection.\n\n### Return\n- Article detail (body / title / author / cover / publish time / album info)\n\n### Response structure & JSON Path\n#### `raw=false` (simplified projection):\n- `data` has only 4 top-level fields; the article body is aggregated in `content`:\n - `$.data.url`: article URL\n - `$.data.bizUin`: official account bizUin (int)\n - `$.data.itemIdx`: article position index\n - `$.data.content`: parsed body object, common paths:\n - `$.data.content.title`: title\n - `$.data.content.nick_name` / `$.data.content.user_name`: account name / gh_username\n - `$.data.content.author`: author\n - `$.data.content.desc`: digest\n - `$.data.content.create_time`: publish time (text like `\"2025-03-05 12:22\"`)\n - `$.data.content.ori_create_time`: publish timestamp (int seconds)\n - `$.data.content.cdn_url`: cover image\n - `$.data.content.comment_id`: comment id (internal id fed into comment endpoints)\n - `$.data.content.appmsgalbuminfo`: album info (`album_id` / `title` / prev & next links)\n - `$.data.content.content_text`: plain text extracted from the body HTML\n#### `raw=true` (raw):\n- `data` is the full item (all fields of `raw=false`, plus template / cache / time metadata):\n - `$.data.url` / `$.data.bizUin` / `$.data.itemIdx`: same as simplified mode\n - `$.data.msgId`: message id\n - `$.data.lastModifyTime`: last modified timestamp\n - `$.data.tmplVersion` / `$.data.tmplVersions[]`: H5 template versions\n - `$.data.clientCacheTime`: client cache seconds\n - `$.data.content.*`: same structure as `content` of `raw=false` (also includes `content_text`)\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_wechat_mp_v2_fetch_article_detail", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Article detail (body / title / author / cover / publish time / album info)\n\n### Response structure & JSON Path\n#### `raw=false` (simplified projection):\n- `data` has only 4 top-level fields; the article body is aggregated in `content`:\n - `$.data.url`: article URL\n - `$.data.bizUin`: official account bizUin (int)\n - `$.data.itemIdx`: article position index\n - `$.data.content`: parsed body object, common paths:\n - `$.data.content.title`: title\n - `$.data.content.nick_name` / `$.data.content.user_name`: account name / gh_username\n - `$.data.content.author`: author\n - `$.data.content.desc`: digest\n - `$.data.content.create_time`: publish time (text like `\"2025-03-05 12:22\"`)\n - `$.data.content.ori_create_time`: publish timestamp (int seconds)\n - `$.data.content.cdn_url`: cover image\n - `$.data.content.comment_id`: comment id (internal id fed into comment endpoints)\n - `$.data.content.appmsgalbuminfo`: album info (`album_id` / `title` / prev & next links)\n - `$.data.content.content_text`: plain text extracted from the body HTML\n#### `raw=true` (raw):\n- `data` is the full item (all fields of `raw=false`, plus template / cache / time metadata):\n - `$.data.url` / `$.data.bizUin` / `$.data.itemIdx`: same as simplified mode\n - `$.data.msgId`: message id\n - `$.data.lastModifyTime`: last modified timestamp\n - `$.data.tmplVersion` / `$.data.tmplVersions[]`: H5 template versions\n - `$.data.clientCacheTime`: client cache seconds\n - `$.data.content.*`: same structure as `content` of `raw=false` (also includes `content_text`)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "wechat_mp fetch_article_detail", "tags": [ "tikhub.wechat_mp" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "4b937f0c239e" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/wechat_mp/v2/fetch_article_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_wechat_mp_v2_fetch_article_detail", "method": "POST", "path": "/apis/v1/tikhub/wechat_mp/v2/fetch_article_detail" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "url": { "type": "string", "maxLength": 2048, "pattern": "^https?://mp\\.weixin\\.qq\\.com/s([/?].+)?$", "title": "Url", "description": "… or long URL with __biz", "example": "https://mp.weixin.qq.com/s/TSNQKkRpN1qbKsT7BvzqIw" }, "raw": { "type": "boolean", "title": "Raw", "description": "True=raw response; False=simplified parsed structure", "default": true } }, "type": "object", "required": [ "url" ], "title": "FetchArticleDetailRequest" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:2003e794c8048e0eed7b0b0973f1909a6b7a17f30abe7166b45d5756d8758717" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/wechat_mp/v2/fetch_article_detail \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"url\": \"https://mp.weixin.qq.com/s/TSNQKkRpN1qbKsT7BvzqIw\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-wechat_mp-v2-fetch_article_detail" } }, "/apis/v1/tikhub/wechat_mp/v2/fetch_article_detail_h5": { "post": { "description": "WeChat Official Accounts (v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Fetch WeChat MP article detail via the H5 channel. **Recommended by default**: the body is\n more reliable and the field coverage is the widest.\n- Independent from `/tikhub/wechat_mp/v2/fetch_article_detail`; neither falls back to the other.\n\n### Parameters\n- url: WeChat MP article URL.\n- raw: Optional, default True. True = extra meta fields; False = core fields only.\n Top-level shape is identical either way.\n\n### Returns\n- Article detail (title / author / cover / publish time / album / tags / images ...)\n\nAPI references: `fetch_article_detail` = `POST /tikhub/wechat_mp/v2/fetch_article_detail` (operationId: `post_tikhub_wechat_mp_v2_fetch_article_detail`).\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_wechat_mp_v2_fetch_article_detail_h5", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- Article detail (title / author / cover / publish time / album / tags / images ...)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "wechat_mp fetch_article_detail_h5", "tags": [ "tikhub.wechat_mp" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "04a2456b1940" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/wechat_mp/v2/fetch_article_detail_h5", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_wechat_mp_v2_fetch_article_detail_h5", "method": "POST", "path": "/apis/v1/tikhub/wechat_mp/v2/fetch_article_detail_h5" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "url": { "type": "string", "maxLength": 2048, "pattern": "^https?://mp\\.weixin\\.qq\\.com/s([/?].+)?$", "title": "Url", "description": "… or long URL with __biz", "example": "https://mp.weixin.qq.com/s/TSNQKkRpN1qbKsT7BvzqIw" }, "raw": { "type": "boolean", "title": "Raw", "description": "True=raw response; False=simplified parsed structure", "default": true } }, "type": "object", "required": [ "url" ], "title": "FetchArticleDetailRequest" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:81d8dc5aceb2ca07f1afac6471c7080b07c9307397d0b03328adcfc942d3daa9" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/wechat_mp/v2/fetch_article_detail_h5 \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"url\": \"https://mp.weixin.qq.com/s/TSNQKkRpN1qbKsT7BvzqIw\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-wechat_mp-v2-fetch_article_detail_h5" } }, "/apis/v1/tikhub/wechat_mp/v2/fetch_article_stats": { "post": { "description": "WeChat Official Accounts (v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Pass an article URL to get its interaction metrics (reads / likes / \"wow\" / shares / favorites / comments).\n\n- ⏱️ Due to WeChat server latency, this endpoint responds slowly; please set your client request timeout to 30 seconds — a timeout that is too small may result in being billed without receiving the response.\n\n### Parameters\n- url: WeChat MP article URL (`https://mp.weixin.qq.com/s/…`). E.g. `https://mp.weixin.qq.com/s/TSNQKkRpN1qbKsT7BvzqIw`\n- raw: Optional, default True. True=full raw stats object (with `show_*` visibility flags); False=simplified counts only.\n\n### Return\n- Article interaction stats\n\n### Response structure & JSON Path\n#### `raw=false` (simplified counts):\n- `data` contains 7 count fields:\n - `$.data.read_num`: read count\n - `$.data.like_count`: like count\n - `$.data.old_like_count`: \"wow\" count (old \"Looking\")\n - `$.data.share_count`: share count\n - `$.data.collect_count`: favorite count\n - `$.data.comment_count`: comment count\n - `$.data.star_num`: star / like count\n#### `raw=true` (raw):\n- `data` is the full raw stats object: all counts of `raw=false` (same names and meanings), plus visibility / status flags:\n - Counts: `$.data.read_num` / `$.data.like_count` / `$.data.old_like_count` / `$.data.share_count` / `$.data.collect_count` / `$.data.comment_count` / `$.data.star_num`\n - Visibility flags: `$.data.show_like` / `$.data.show_old_like` / `$.data.show_share` / `$.data.show_collect` / `$.data.show_read` / `$.data.show_star` (and corresponding `*_gray` flags)\n - Status: `$.data.comment_enabled` (comment switch) / `$.data.get_data_succ` (fetch success) / `$.data.is_subscribed` / `$.data.verify_status` / `$.data.can_use_star`\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_wechat_mp_v2_fetch_article_stats", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Article interaction stats\n\n### Response structure & JSON Path\n#### `raw=false` (simplified counts):\n- `data` contains 7 count fields:\n - `$.data.read_num`: read count\n - `$.data.like_count`: like count\n - `$.data.old_like_count`: \"wow\" count (old \"Looking\")\n - `$.data.share_count`: share count\n - `$.data.collect_count`: favorite count\n - `$.data.comment_count`: comment count\n - `$.data.star_num`: star / like count\n#### `raw=true` (raw):\n- `data` is the full raw stats object: all counts of `raw=false` (same names and meanings), plus visibility / status flags:\n - Counts: `$.data.read_num` / `$.data.like_count` / `$.data.old_like_count` / `$.data.share_count` / `$.data.collect_count` / `$.data.comment_count` / `$.data.star_num`\n - Visibility flags: `$.data.show_like` / `$.data.show_old_like` / `$.data.show_share` / `$.data.show_collect` / `$.data.show_read` / `$.data.show_star` (and corresponding `*_gray` flags)\n - Status: `$.data.comment_enabled` (comment switch) / `$.data.get_data_succ` (fetch success) / `$.data.is_subscribed` / `$.data.verify_status` / `$.data.can_use_star`", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "wechat_mp fetch_article_stats", "tags": [ "tikhub.wechat_mp" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "ba952e7a7162" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/wechat_mp/v2/fetch_article_stats", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_wechat_mp_v2_fetch_article_stats", "method": "POST", "path": "/apis/v1/tikhub/wechat_mp/v2/fetch_article_stats" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "url": { "type": "string", "maxLength": 2048, "pattern": "^https?://mp\\.weixin\\.qq\\.com/s([/?].+)?$", "title": "Url", "description": "… or long URL with __biz", "example": "https://mp.weixin.qq.com/s/TSNQKkRpN1qbKsT7BvzqIw" }, "raw": { "type": "boolean", "title": "Raw", "description": "True=raw response; False=simplified parsed structure", "default": true } }, "type": "object", "required": [ "url" ], "title": "FetchArticleDetailRequest" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:4a763e464e8801ca02eac7f5313832144284725764fd69c6d53ebac864baf658" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/wechat_mp/v2/fetch_article_stats \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"url\": \"https://mp.weixin.qq.com/s/TSNQKkRpN1qbKsT7BvzqIw\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-wechat_mp-v2-fetch_article_stats" } }, "/apis/v1/tikhub/wechat_mp/v2/fetch_article_stats_h5": { "post": { "description": "WeChat Official Accounts (v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Fetch comment counts for a WeChat MP article via the H5 channel.\n- Read count / likes / shares / favorites are **not available** here: they are returned as\n `null` and listed in `$.data.unavailable[]` (never faked as `0`). Use\n `/tikhub/wechat_mp/v2/fetch_article_stats` when you need them.\n\n### Parameters\n- url: WeChat MP article URL.\n- raw: Optional, default True. True = include raw counter fields; False = counts only.\n\n### Returns\n- comment_count / elected_comment_count; other metrics are null and listed in unavailable[]\n\nAPI references: `fetch_article_stats` = `POST /tikhub/wechat_mp/v2/fetch_article_stats` (operationId: `post_tikhub_wechat_mp_v2_fetch_article_stats`).\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_wechat_mp_v2_fetch_article_stats_h5", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- comment_count / elected_comment_count; other metrics are null and listed in unavailable[]", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "wechat_mp fetch_article_stats_h5", "tags": [ "tikhub.wechat_mp" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "643de80b58e7" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/wechat_mp/v2/fetch_article_stats_h5", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_wechat_mp_v2_fetch_article_stats_h5", "method": "POST", "path": "/apis/v1/tikhub/wechat_mp/v2/fetch_article_stats_h5" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "url": { "type": "string", "maxLength": 2048, "pattern": "^https?://mp\\.weixin\\.qq\\.com/s([/?].+)?$", "title": "Url", "description": "… or long URL with __biz", "example": "https://mp.weixin.qq.com/s/TSNQKkRpN1qbKsT7BvzqIw" }, "raw": { "type": "boolean", "title": "Raw", "description": "True=raw response; False=simplified parsed structure", "default": true }, "comment_id": { "title": "Comment Id", "description": "Article comment id (optional, performance shortcut): when omitted, upstream must fetch and parse the whole article HTML to obtain it, which accounts for about half of this endpoint's latency", "type": [ "string", "null" ], "maxLength": 32, "pattern": "^[0-9]*$" } }, "type": "object", "required": [ "url" ], "title": "FetchArticleStatsH5Request", "description": "`/tikhub/wechat_mp/v2/fetch_article_stats_h5` FetchArticleDetailRequest comment_id\n\nAPI references: `fetch_article_stats_h5` = `POST /tikhub/wechat_mp/v2/fetch_article_stats_h5` (operationId: `post_tikhub_wechat_mp_v2_fetch_article_stats_h5`)." } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:ab4c679e70ac1364f5b130ddf6b0521335f66e39fdff73db58922d402713ae7f" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/wechat_mp/v2/fetch_article_stats_h5 \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"url\": \"https://mp.weixin.qq.com/s/TSNQKkRpN1qbKsT7BvzqIw\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-wechat_mp-v2-fetch_article_stats_h5" } }, "/apis/v1/tikhub/wechat_mp/v2/fetch_comment_replies": { "post": { "description": "WeChat Official Accounts (v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get the second-level replies under a first-level comment.\n- Chain: first call `fetch_article_comments` to get each comment's `content_id`, then feed it into this endpoint.\n\n- ⏱️ Due to WeChat server latency, this endpoint responds slowly; please set your client request timeout to 30 seconds — a timeout that is too small may result in being billed without receiving the response.\n- ⚠️ Large-integer ID precision: IDs such as `content_id` / `reply_id` in the response are 64-bit big integers beyond JavaScript's safe-integer range (2^53-1). Always receive / pass such IDs as **strings** (parse JSON with json-bigint or read them as text), never through JS `Number`. Swagger UI rounds the trailing digits of huge integers in its docs view — this is expected and does not affect the actual data returned by the API.\n\n### Parameters\n- url: WeChat MP article URL (`https://mp.weixin.qq.com/s/…`). E.g. `http://mp.weixin.qq.com/s?__biz=Mzk3NTA0MzM5NA==&mid=2247483745&idx=1&sn=3f34e768cf457a501038991ed30be1f4#rd`\n- content_id: Optional (numeric). `content_id` of the target first-level comment, from `$.data.comments[N].content_id` of the `fetch_article_comments` response; **defaults to the first comment that has replies when omitted**. E.g. `12109128638545265979`\n- offset: Optional, default 0 (>=0). Reply pagination offset; 0 for the first page, pass `next_offset` from the previous response when `has_more=true`.\n- Note: `all_pages` was removed upstream — it issued up to 30 upstream requests per billed call and omitted `has_more` / `next_offset`, so callers could not tell the result was truncated. Paginate with `offset` / `next_offset` instead.\n- raw: Optional, default True. True=full raw reply objects; False=simplified replies.\n\n### Return\n- Second-level reply list with pagination info\n\n> Note: the **outer structure is identical** for `raw=true` and `raw=false`; the difference is only in the field granularity of each `replies[]` element (simplified view vs full raw object).\n\n### Response structure & JSON Path\n#### `raw=false` (simplified replies):\n- `$.data.content_id`: target comment id (echo)\n- `$.data.parent_nick`: nickname of the parent comment (the one replied to)\n- `$.data.reply_total`: total second-level replies\n- `$.data.count`: number of replies returned this time\n- `$.data.replies[N].reply_id`: reply id\n- `$.data.replies[N].nick_name`: replier nickname\n- `$.data.replies[N].content`: reply content\n- `$.data.replies[N].create_time`: reply timestamp\n- `$.data.replies[N].ip_wording`: IP region\n- `$.data.replies[N].identity_name`: identity label\n- `$.data.replies[N].from_ai` / `reply_is_elected`: AI reply / featured flags\n- Pagination fields: `$.data.offset` / `$.data.next_offset` / `$.data.has_more`\n#### `raw=true` (raw):\n- Outer `content_id` / `parent_nick` / `reply_total` / `count` (and `offset` / `next_offset` / `has_more` in single-page mode) are **identical** to `raw=false`; the only difference is that `replies[]` elements are full raw reply objects (including fields projected away in `raw=false`). Common paths remain `$.data.replies[N].content` / `$.data.replies[N].reply_id` / `$.data.replies[N].nick_name`.\n\nAPI references: `fetch_article_comments` = `POST /tikhub/wechat_mp/v2/fetch_article_comments` (operationId: `post_tikhub_wechat_mp_v2_fetch_article_comments`).\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_wechat_mp_v2_fetch_comment_replies", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Second-level reply list with pagination info\n\n> Note: the **outer structure is identical** for `raw=true` and `raw=false`; the difference is only in the field granularity of each `replies[]` element (simplified view vs full raw object).\n\n### Response structure & JSON Path\n#### `raw=false` (simplified replies):\n- `$.data.content_id`: target comment id (echo)\n- `$.data.parent_nick`: nickname of the parent comment (the one replied to)\n- `$.data.reply_total`: total second-level replies\n- `$.data.count`: number of replies returned this time\n- `$.data.replies[N].reply_id`: reply id\n- `$.data.replies[N].nick_name`: replier nickname\n- `$.data.replies[N].content`: reply content\n- `$.data.replies[N].create_time`: reply timestamp\n- `$.data.replies[N].ip_wording`: IP region\n- `$.data.replies[N].identity_name`: identity label\n- `$.data.replies[N].from_ai` / `reply_is_elected`: AI reply / featured flags\n- Pagination fields: `$.data.offset` / `$.data.next_offset` / `$.data.has_more`\n#### `raw=true` (raw):\n- Outer `content_id` / `parent_nick` / `reply_total` / `count` (and `offset` / `next_offset` / `has_more` in single-page mode) are **identical** to `raw=false`; the only difference is that `replies[]` elements are full raw reply objects (including fields projected away in `raw=false`). Common paths remain `$.data.replies[N].content` / `$.data.replies[N].reply_id` / `$.data.replies[N].nick_name`.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "wechat_mp fetch_comment_replies", "tags": [ "tikhub.wechat_mp" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "76568aa81e51" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/wechat_mp/v2/fetch_comment_replies", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_wechat_mp_v2_fetch_comment_replies", "method": "POST", "path": "/apis/v1/tikhub/wechat_mp/v2/fetch_comment_replies" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "url": { "type": "string", "maxLength": 2048, "pattern": "^https?://mp\\.weixin\\.qq\\.com/s([/?].+)?$", "title": "Url", "description": "WeChat MP article URL (`https://mp.weixin.qq.com/s/…`). E.g. `http://mp.weixin.qq.com/s?__biz=Mzk3NTA0MzM5NA==&mid=2247483745&idx=1&sn=3f34e768cf457a501038991ed30be1f4#rd`", "example": "http://mp.weixin.qq.com/s?__biz=Mzk3NTA0MzM5NA==&mid=2247483745&idx=1&sn=3f34e768cf457a501038991ed30be1f4#rd" }, "content_id": { "title": "Content Id", "description": "Optional (numeric). `content_id` of the target first-level comment, from `$.data.comments[N].content_id` of the `fetch_article_comments` response; **defaults to the first comment that has replies when omitted**. E.g. `12109128638545265979`\n\nAPI references: `fetch_article_comments` = `POST /tikhub/wechat_mp/v2/fetch_article_comments` (operationId: `post_tikhub_wechat_mp_v2_fetch_article_comments`).", "default": "", "example": "12109128638545265979", "type": [ "string", "null" ], "maxLength": 32, "pattern": "^[0-9]*$" }, "offset": { "type": "integer", "minimum": 0.0, "title": "Offset", "description": "Optional, default 0 (>=0). Reply pagination offset; 0 for the first page, pass `next_offset` from the previous response when `has_more=true`.", "default": 0 }, "comment_id": { "title": "Comment Id", "description": "Article comment id (optional, performance shortcut): when omitted, upstream must fetch and parse the whole article HTML to obtain it, which accounts for about half of this endpoint's latency", "type": [ "string", "null" ], "maxLength": 32, "pattern": "^[0-9]*$" }, "raw": { "type": "boolean", "title": "Raw", "description": "True=raw response; False=simplified parsed structure", "default": true } }, "type": "object", "required": [ "url" ], "title": "FetchCommentRepliesRequest" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e3928f09eb5b2afde19691d8892751f76361aa8b59f56df3450c84ad5727e8dc" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/wechat_mp/v2/fetch_comment_replies \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"url\": \"http://mp.weixin.qq.com/s?__biz=Mzk3NTA0MzM5NA==&mid=2247483745&idx=1&sn=3f34e768cf457a501038991ed30be1f4#rd\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-wechat_mp-v2-fetch_comment_replies" } }, "/apis/v1/tikhub/wechat_mp/v2/fetch_related_articles": { "post": { "description": "WeChat Official Accounts (v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Pass an article URL to get the \"related articles\" at the bottom of the article. Articles without this feature return an empty list.\n\n- ⏱️ Due to WeChat server latency, this endpoint responds slowly; please set your client request timeout to 30 seconds — a timeout that is too small may result in being billed without receiving the response.\n\n### Parameters\n- url: WeChat MP article URL (long or short form). E.g. `https://mp.weixin.qq.com/s/TSNQKkRpN1qbKsT7BvzqIw` (this article has related articles disabled, returns empty)\n- raw: Optional, default True. True=full raw response; False=simplified projection.\n\n### Return\n- Related article list\n\n### Response structure & JSON Path\n#### `raw=false` (simplified projection):\n- `data` is flattened into three fields:\n - `$.data.ret`: return code (0 = OK)\n - `$.data.count`: number of related articles\n - `$.data.articles[]`: related article list (merged from whichever source list hits; `[]` when empty)\n#### `raw=true` (raw):\n- `data` is the full raw response:\n - `$.data.article_size`: number of related articles (corresponds to `count` in simplified mode)\n - `$.data.list[]`: raw related article list (corresponds to `articles` in simplified mode)\n - `$.data.base_resp.ret`: return code (corresponds to `ret` in simplified mode); `base_resp.exportkey_token`: export token\n - `$.data.empty_scene`: empty-result scene code; `$.data.show_rec_reason`: whether to show recommendation reason; `$.data.report_info`: report info (JSON string)\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_wechat_mp_v2_fetch_related_articles", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Related article list\n\n### Response structure & JSON Path\n#### `raw=false` (simplified projection):\n- `data` is flattened into three fields:\n - `$.data.ret`: return code (0 = OK)\n - `$.data.count`: number of related articles\n - `$.data.articles[]`: related article list (merged from whichever source list hits; `[]` when empty)\n#### `raw=true` (raw):\n- `data` is the full raw response:\n - `$.data.article_size`: number of related articles (corresponds to `count` in simplified mode)\n - `$.data.list[]`: raw related article list (corresponds to `articles` in simplified mode)\n - `$.data.base_resp.ret`: return code (corresponds to `ret` in simplified mode); `base_resp.exportkey_token`: export token\n - `$.data.empty_scene`: empty-result scene code; `$.data.show_rec_reason`: whether to show recommendation reason; `$.data.report_info`: report info (JSON string)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "wechat_mp fetch_related_articles", "tags": [ "tikhub.wechat_mp" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "84df95fe5e94" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/wechat_mp/v2/fetch_related_articles", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_wechat_mp_v2_fetch_related_articles", "method": "POST", "path": "/apis/v1/tikhub/wechat_mp/v2/fetch_related_articles" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "url": { "type": "string", "maxLength": 2048, "pattern": "^https?://mp\\.weixin\\.qq\\.com/s([/?].+)?$", "title": "Url", "description": "… or long URL with __biz", "example": "https://mp.weixin.qq.com/s/TSNQKkRpN1qbKsT7BvzqIw" }, "raw": { "type": "boolean", "title": "Raw", "description": "True=raw response; False=simplified parsed structure", "default": true } }, "type": "object", "required": [ "url" ], "title": "FetchArticleDetailRequest" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:cee7ac9bb448aac154b9e1b509ab878c816557bd17743dea2e3dac2c8e894ec4" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/wechat_mp/v2/fetch_related_articles \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"url\": \"https://mp.weixin.qq.com/s/TSNQKkRpN1qbKsT7BvzqIw\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-wechat_mp-v2-fetch_related_articles" } }, "/apis/v1/tikhub/wechat_search/v2/fetch_search": { "post": { "description": "WeChat Search (v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- WeChat universal search universal search; the vertical is switched by the `business_type` **string key** — just pass a keyword.\n- **Verified to return data**: all / official accounts (incl. service accounts and Channels) / articles / Channels videos / stickers.\n- ⚠️ The other verticals (live streams, Moments, news, books, listen, images, encyclopedia, WeChat Index, underline, comments, photos, mini games, AI search) are gated server-side per account & region and currently always come back empty. A non-empty `no_more` is the universal signal (top level in both `raw=true` and `raw=false`); `raw=false` additionally gives `count=0` + `items=[]`. Still billed as a normal call.\n\n- ⏱️ Due to WeChat server latency, this endpoint responds slowly; please set your client request timeout to 30 seconds — a timeout that is too small may result in being billed without receiving the response.\n- ⚠️ Large-integer ID precision: IDs such as `docID` / `feedNonceId` in the response are 64-bit big integers beyond JavaScript's safe-integer range (2^53-1). Always receive / pass such IDs as **strings** (parse JSON with json-bigint or read them as text), never through JS `Number`. Swagger UI rounds the trailing digits of huge integers in its docs view — this is expected and does not affect the actual data returned by the API.\n\n### Parameters\n- keyword: Search keyword (1-100 chars after trimming). For example, an account display name\n- business_type: Optional, default `all`. Vertical string key (18 total). **Verified to return data**: `all` / `account` / `article` / `video` / `sticker`. The rest (`underline` / `encyclopedia` / `live_stream` / `comment` / `listen` / `news` / `photos` / `book` / `moments` / `image` / `mini_game` / `weixin_index` / `ai_search`) are gated server-side per account & region and currently always come back empty. Any value outside this list is rejected (422).\n- sort: Optional, default `default`. Sort (result page \"sort\" dropdown, common to all verticals) — `default`/0 (relevance) / `latest`/1 (newest) / `hot`/2 (most liked); string key or integer, invalid values rejected (400).\n- publish_time: Optional, default `all`. Publish time (result page \"time\" dropdown, common) — `all`/0 / `day`/1 / `week`/2 / `half_year`/3; string key or integer, invalid values rejected (400).\n- offset: Optional, default 0 (>=0). Pass `0` for the first page; **use `cursor` to paginate — offset alone does not work** (it returns the first page every time).\n- cursor: Optional. Pagination cursor. Leave empty for the first page; for the next page pass back the `cursor` returned in the previous response (repeat the same `sort` / `publish_time`), and use `continue_flag` to check whether there are more pages.\n- raw: Optional, default True. True=raw search response; False=simplified parsing.\n\n💡 The \"duration\" filter specific to the video vertical is available at `/tikhub/wechat_search/v2/fetch_search_videos` (`business_type=video` + `duration`).\n\n### Return\n- Search result list (structure varies slightly by vertical)\n\n### Typical chains\n- 💡 **To get Channels video detail (media download address / decode_key)**: video result items from search (`video` / `all`) do **not** contain media directly — only `exportId` (+ `jumpInfo.extInfo.feedNonceId`). To download / decrypt: take `exportId` → call the Channels V2 endpoint `/tikhub/wechat_channels/v2/fetch_video_detail` (pass `export_id`) to get `media` (`url` / `url_token` / `decode_key`) and the plain `username`. See that endpoint's docs for the full chain and decryption notes.\n- The `jumpInfo.userName` (`gh_…`) of official account result items can be fed into the MP V2 endpoints `/tikhub/wechat_mp/v2/fetch_account_profile` / `fetch_account_articles`.\n\n### Response structure & JSON Path\n#### `raw=false` (simplified, snake_case):\n- Keyword echo: `$.data.keyword`\n- Effective vertical code (e.g. account=33554499): `$.data.business_type`\n- Total results: `$.data.total` — the **maximum** `totalCount` scanned across every box and subBox (a vertical's `totalCount` hangs off `subBoxes`; the All tab has no single total, so this is the largest contributing box). **null on a zero-result page** (no positive totalCount anywhere), so it is always null for the always-empty verticals\n- Has next page: `$.data.continue_flag`\n- Pagination cursor (pass back as the `cursor` parameter for the next page): `$.data.cursor`\n- Server-side offset (informational only; passing it back alone does **not** paginate): `$.data.offset`\n- Results on this page: `$.data.count`\n- Flattened result item list (items of all boxes / subBoxes merged): `$.data.items[]`\n- Server-issued vertical tab list (only present for `business_type=all`, null otherwise): `$.data.categories[]` — each entry has `.type` / `.word` / `.extra_kvs`. **This is the authoritative list of verticals actually available to the serving account.** Note `.type` is the vertical's **integer code** (e.g. 33554499) while this endpoint's `business_type` accepts only the 18 **string keys** above — an integer is rejected (422), so map it yourself (e.g. 33554499 → `account`).\n- Server wording for a zero-result page: `$.data.no_more` (present = a legitimate empty result from WeChat, **not** a failed call)\n- Single item (N is the index; fields vary by vertical; below is an `account` example):\n - Title (with `` highlight): `$.data.items[N].title`\n - Description: `$.data.items[N].desc`\n - Document id: `$.data.items[N].docID`\n - Type name: `$.data.items[N].accTypeName`\n - Jump info: `$.data.items[N].jumpInfo` (`.userName` = `gh_…`, `.nickName`, `.signature`)\n - Video vertical items also carry `exportId` (+ `jumpInfo.extInfo.feedNonceId`) → see \"Typical chains\" above\n#### `raw=true` (raw, default for this endpoint):\n- `data` top level: `keyword` / `business_type` / `results` (items are **not** flattened) / `total` / `continue_flag` / `offset` / `cursor` / `categories` / `no_more` (`total` / `categories` / `no_more` are top level in both modes — the key sets are aligned)\n- Full result set: `$.data.results`\n- Result box array: `$.data.results.data[]`; each box's results are in `$.data.results.data[M].items[]` and `$.data.results.data[M].subBoxes[K].items[]` — the `items[]` of `raw=false` is the flattened merge of these.\n- Has next page: `$.data.continue_flag` (top level for both `raw=true` / `raw=false`)\n- Pagination cursor: `$.data.cursor` — pass it back as the `cursor` parameter for the next page; `$.data.offset` is only the server-side offset and passing it back alone does **not** paginate\n- Read the total from the top level `$.data.total` (present in both raw modes) — it is the **maximum** of `$.data.results.data[M].totalCount` and `$.data.results.data[M].subBoxes[K].totalCount`; a vertical's number hangs off `subBoxes`, so reading only the top-level box's `totalCount` yields null\n- For result iteration, prefer `raw=false` (items already flattened) for cleaner paths.\n\nAPI references: `fetch_account_articles` = `POST /tikhub/wechat_mp/v2/fetch_account_articles` (operationId: `post_tikhub_wechat_mp_v2_fetch_account_articles`); `fetch_account_profile` = `POST /tikhub/wechat_mp/v2/fetch_account_profile` (operationId: `post_tikhub_wechat_mp_v2_fetch_account_profile`); `fetch_search_videos` = `POST /tikhub/wechat_search/v2/fetch_search_videos` (operationId: `post_tikhub_wechat_search_v2_fetch_search_videos`); `fetch_video_detail` = `POST /tikhub/wechat_channels/v2/fetch_video_detail` (operationId: `post_tikhub_wechat_channels_v2_fetch_video_detail`).\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_wechat_search_v2_fetch_search", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Search result list (structure varies slightly by vertical)\n\n### Response structure & JSON Path\n#### `raw=false` (simplified, snake_case):\n- Keyword echo: `$.data.keyword`\n- Effective vertical code (e.g. account=33554499): `$.data.business_type`\n- Total results: `$.data.total` — the **maximum** `totalCount` scanned across every box and subBox (a vertical's `totalCount` hangs off `subBoxes`; the All tab has no single total, so this is the largest contributing box). **null on a zero-result page** (no positive totalCount anywhere), so it is always null for the always-empty verticals\n- Has next page: `$.data.continue_flag`\n- Pagination cursor (pass back as the `cursor` parameter for the next page): `$.data.cursor`\n- Server-side offset (informational only; passing it back alone does **not** paginate): `$.data.offset`\n- Results on this page: `$.data.count`\n- Flattened result item list (items of all boxes / subBoxes merged): `$.data.items[]`\n- Server-issued vertical tab list (only present for `business_type=all`, null otherwise): `$.data.categories[]` — each entry has `.type` / `.word` / `.extra_kvs`. **This is the authoritative list of verticals actually available to the serving account.** Note `.type` is the vertical's **integer code** (e.g. 33554499) while this endpoint's `business_type` accepts only the 18 **string keys** above — an integer is rejected (422), so map it yourself (e.g. 33554499 → `account`).\n- Server wording for a zero-result page: `$.data.no_more` (present = a legitimate empty result from WeChat, **not** a failed call)\n- Single item (N is the index; fields vary by vertical; below is an `account` example):\n - Title (with `` highlight): `$.data.items[N].title`\n - Description: `$.data.items[N].desc`\n - Document id: `$.data.items[N].docID`\n - Type name: `$.data.items[N].accTypeName`\n - Jump info: `$.data.items[N].jumpInfo` (`.userName` = `gh_…`, `.nickName`, `.signature`)\n - Video vertical items also carry `exportId` (+ `jumpInfo.extInfo.feedNonceId`) → see \"Typical chains\" above\n#### `raw=true` (raw, default for this endpoint):\n- `data` top level: `keyword` / `business_type` / `results` (items are **not** flattened) / `total` / `continue_flag` / `offset` / `cursor` / `categories` / `no_more` (`total` / `categories` / `no_more` are top level in both modes — the key sets are aligned)\n- Full result set: `$.data.results`\n- Result box array: `$.data.results.data[]`; each box's results are in `$.data.results.data[M].items[]` and `$.data.results.data[M].subBoxes[K].items[]` — the `items[]` of `raw=false` is the flattened merge of these.\n- Has next page: `$.data.continue_flag` (top level for both `raw=true` / `raw=false`)\n- Pagination cursor: `$.data.cursor` — pass it back as the `cursor` parameter for the next page; `$.data.offset` is only the server-side offset and passing it back alone does **not** paginate\n- Read the total from the top level `$.data.total` (present in both raw modes) — it is the **maximum** of `$.data.results.data[M].totalCount` and `$.data.results.data[M].subBoxes[K].totalCount`; a vertical's number hangs off `subBoxes`, so reading only the top-level box's `totalCount` yields null\n- For result iteration, prefer `raw=false` (items already flattened) for cleaner paths.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "wechat_search fetch_search", "tags": [ "tikhub.wechat_search" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "bb9cd5d7e56e" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/wechat_search/v2/fetch_search", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_wechat_search_v2_fetch_search", "method": "POST", "path": "/apis/v1/tikhub/wechat_search/v2/fetch_search" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "keyword": { "type": "string", "maxLength": 100, "minLength": 1, "title": "Keyword", "description": "Search keyword, 1-100 characters after trimming. For account searches, use the account display name.", "example": "People's Daily" }, "business_type": { "type": "string", "enum": [ "all", "account", "article", "video", "sticker", "underline", "encyclopedia", "live_stream", "comment", "listen", "news", "photos", "book", "moments", "image", "mini_game", "weixin_index", "ai_search" ], "title": "Business Type", "description": "ai_search) are gated server-side per account & region and currently always come back empty (count=0 plus a no_more message — still billed as a normal call). Use the `categories` field of an `all` search for the authoritative per-account tab list. Values outside this list are rejected (422\n\nUsage: Optional, default `all`. Vertical string key (18 total). **Verified to return data**: `all` / `account` / `article` / `video` / `sticker`. The rest (`underline` / `encyclopedia` / `live_stream` / `comment` / `listen` / `news` / `photos` / `book` / `moments` / `image` / `mini_game` / `weixin_index` / `ai_search`) are gated server-side per account & region and currently always come back empty. Any value outside this list is rejected (422).", "default": "all", "example": "account" }, "sort": { "anyOf": [ { "type": "integer" }, { "type": "string" } ], "title": "Sort", "description": "Optional, default `default`. Sort (result page \"sort\" dropdown, common to all verticals) — `default`/0 (relevance) / `latest`/1 (newest) / `hot`/2 (most liked); string key or integer, invalid values rejected (400).", "default": "default", "example": "hot" }, "publish_time": { "anyOf": [ { "type": "integer" }, { "type": "string" } ], "title": "Publish Time", "description": "Optional, default `all`. Publish time (result page \"time\" dropdown, common) — `all`/0 / `day`/1 / `week`/2 / `half_year`/3; string key or integer, invalid values rejected (400).", "default": "all", "example": "week" }, "offset": { "type": "integer", "minimum": 0.0, "title": "Offset", "description": "Optional, default 0 (>=0). Pass `0` for the first page; **use `cursor` to paginate — offset alone does not work** (it returns the first page every time).", "default": 0 }, "cursor": { "title": "Cursor", "description": "Optional. Pagination cursor. Leave empty for the first page; for the next page pass back the `cursor` returned in the previous response (repeat the same `sort` / `publish_time`), and use `continue_flag` to check whether there are more pages.", "type": [ "string", "null" ] }, "raw": { "type": "boolean", "title": "Raw", "description": "True=raw search response; False=simplified parsed structure", "default": true } }, "type": "object", "required": [ "keyword" ], "title": "FetchSearchRequest" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:6928008c45d7be501dfcd18a04dfb8311e40ba46a45c9f572ff7e8741df83417" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/wechat_search/v2/fetch_search \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"keyword\": \"People'\"'\"'s Daily\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-wechat_search-v2-fetch_search" } }, "/apis/v1/tikhub/wechat_search/v2/fetch_search_videos": { "post": { "description": "WeChat Search (v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Search WeChat Channels videos specifically (`video` vertical), with the result page's \"duration\" filter, \"relevance/newest/most-liked\" sort, and \"time\" dropdown.\n- Equivalent to universal search `/tikhub/wechat_search/v2/fetch_search` (`business_type=video`) plus filters; all filters are verified to work.\n\n- ⏱️ Due to WeChat server latency, this endpoint responds slowly; please set your client request timeout to 30 seconds — a timeout that is too small may result in being billed without receiving the response.\n- ⚠️ Large-integer ID precision: IDs such as `docID` / `feedNonceId` in the response are 64-bit big integers beyond JavaScript's safe-integer range (2^53-1). Always receive / pass such IDs as **strings** (parse JSON with json-bigint or read them as text), never through JS `Number`. Swagger UI rounds the trailing digits of huge integers in its docs view — this is expected and does not affect the actual data returned by the API.\n\n### Parameters\n- keyword: Search keyword (1-100 chars after trimming). For example, `food`\n- duration: Optional, default `all`. Duration tier (Channels video only) — `all`/0 / `short`/1 (<5min) / `medium`/2 (5-10min) / `long`/3 (20min+); string key or integer, invalid values rejected (400).\n- sort: Optional, default `default`. Sort — `default`/0 (relevance) / `latest`/1 (newest) / `hot`/2 (most liked); string key or integer, invalid values rejected (400).\n- publish_time: Optional, default `all`. Publish time — `all`/0 / `day`/1 / `week`/2 / `half_year`/3; string key or integer, invalid values rejected (400).\n- offset: Optional, default 0 (>=0). Pass `0` for the first page; use `cursor` to paginate (offset alone does not work).\n- cursor: Optional. Pagination cursor, same usage as universal search `/tikhub/wechat_search/v2/fetch_search`. Leave empty for the first page; for the next page pass back the `cursor` from the previous response (repeat the same `duration` / `sort` / `publish_time`).\n- raw: Optional, default True. True=raw search response; False=simplified parsing.\n\n### Return\n- Channels video search result list (same structure as the `video` vertical of universal search)\n\n### Typical chains\n- 💡 The \"account\" option in the sort dropdown is **not a sort** — it switches to the official-account vertical; use universal search `/tikhub/wechat_search/v2/fetch_search` (`business_type=account`).\n- 💡 **To get Channels video detail (media download address / decode_key)**: video result items do **not** contain media directly — only `exportId` (+ `jumpInfo.extInfo.feedNonceId`). To download / decrypt: take `exportId` → call the Channels V2 endpoint `/tikhub/wechat_channels/v2/fetch_video_detail` (pass `export_id`) to get `media` (`url` / `url_token` / `decode_key`) and the plain `username`. Result fields and response structure are the same as `/tikhub/wechat_search/v2/fetch_search`.\n\nAPI references: `fetch_search` = `POST /tikhub/wechat_search/v2/fetch_search` (operationId: `post_tikhub_wechat_search_v2_fetch_search`); `fetch_video_detail` = `POST /tikhub/wechat_channels/v2/fetch_video_detail` (operationId: `post_tikhub_wechat_channels_v2_fetch_video_detail`).\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_wechat_search_v2_fetch_search_videos", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Channels video search result list (same structure as the `video` vertical of universal search)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "wechat_search fetch_search_videos", "tags": [ "tikhub.wechat_search" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "99d6762a5a9f" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/wechat_search/v2/fetch_search_videos", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_wechat_search_v2_fetch_search_videos", "method": "POST", "path": "/apis/v1/tikhub/wechat_search/v2/fetch_search_videos" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "keyword": { "type": "string", "maxLength": 100, "minLength": 1, "title": "Keyword", "description": "Search keyword, 1-100 characters after trimming.", "example": "food" }, "duration": { "anyOf": [ { "type": "integer" }, { "type": "string" } ], "title": "Duration", "description": "Duration filter for Channels videos: all/0 (default), short/1 (under 5 minutes), medium/2 (5-10 minutes), long/3 (20 minutes or more). Accepts either a string key or integer; invalid values return HTTP 400.", "default": "all", "example": "short" }, "sort": { "anyOf": [ { "type": "integer" }, { "type": "string" } ], "title": "Sort", "description": "Sort order: default/0=relevance (default), latest/1=newest, hot/2=most liked. Accepts either a string key or integer; invalid values return HTTP 400.", "default": "default", "example": "hot" }, "publish_time": { "anyOf": [ { "type": "integer" }, { "type": "string" } ], "title": "Publish Time", "description": "Publication-time filter: all/0 (default), day/1, week/2, half_year/3. Accepts either a string key or integer; invalid values return HTTP 400.", "default": "all", "example": "week" }, "offset": { "type": "integer", "minimum": 0.0, "title": "Offset", "description": "Offset, default 0 and minimum 0. Use cursor for pagination; offset alone does not advance the result page.", "default": 0 }, "cursor": { "title": "Cursor", "description": "Pagination cursor, as in /tikhub/wechat_search/v2/fetch_search. Leave empty for the first page, then pass the previous response cursor verbatim while keeping duration, sort, and publish_time unchanged.\n\nAPI references: `fetch_search` = `POST /tikhub/wechat_search/v2/fetch_search` (operationId: `post_tikhub_wechat_search_v2_fetch_search`).", "type": [ "string", "null" ] }, "raw": { "type": "boolean", "title": "Raw", "description": "True=raw search response; False=simplified parsed structure", "default": true } }, "type": "object", "required": [ "keyword" ], "title": "FetchSearchVideosRequest" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:6f8ab6fa6a443f69302633afc62c6cee6cc43bf258021fe248d43afcb7a77517" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/wechat_search/v2/fetch_search_videos \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"keyword\": \"food\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-wechat_search-v2-fetch_search_videos" } }, "/apis/v1/tikhub/weibo/app/fetch_ai_smart_search": { "get": { "description": "Weibo (app).\n\n### Purpose:\n- Use Weibo AI Smart Search to search, return AI-enhanced search results.\n### Parameters:\n- query: Search keyword (required)\n- page: Page number, starts from 1 (default 1)\n### Return:\n- AI smart search results, including AI-enhanced search content\n### Note:\n- This is AI-enhanced search, results are processed by AI\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_app_fetch_ai_smart_search", "responses": { "200": { "description": "Successful Response\n\n### Return\n- AI smart search results, including AI-enhanced search content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_ai_smart_search", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "bc74d93e16d3" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/app/fetch_ai_smart_search", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_app_fetch_ai_smart_search", "method": "GET", "path": "/apis/v1/tikhub/weibo/app/fetch_ai_smart_search" }, "parameters": [ { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "description": "Page number, starts from 1 (default 1)", "default": 1, "title": "Page" }, "description": "Page number, starts from 1 (default 1)", "example": 1 }, { "name": "query", "in": "query", "required": true, "schema": { "type": "string", "description": "Search keyword", "title": "Query" }, "description": "Search keyword", "example": "Artificial Intelligence" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:8281bbaca826d0c800a8702c3146df35bacb30e6315ae0be74277e02936d6556" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/weibo/app/fetch_ai_smart_search?page=1&query=Artificial+Intelligence' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-app-fetch_ai_smart_search" } }, "/apis/v1/tikhub/weibo/app/fetch_home_recommend_feed": { "get": { "description": "Weibo (app).\n\n### Purpose:\n- Get the home recommend feed from Weibo.\n### Parameters:\n- page: Page number, don't pass for first page, pass \"2\" for second page, and so on\n- count: Items per page, default 15, max 50\n### Return:\n- Home recommend feed data\n### Note:\n- Recommended content based on hot topics and trending events\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_app_fetch_home_recommend_feed", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Home recommend feed data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_home_recommend_feed", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "7c46af2bae9c" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/app/fetch_home_recommend_feed", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_app_fetch_home_recommend_feed", "method": "GET", "path": "/apis/v1/tikhub/weibo/app/fetch_home_recommend_feed" }, "parameters": [ { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 50, "minimum": 1, "description": "Items per page, default 15, max 50", "default": 15, "title": "Count" }, "description": "Items per page, default 15, max 50", "example": 15 }, { "name": "page", "in": "query", "required": false, "schema": { "description": "Page number; omit for the first page, pass 2 for the second page\n\nUsage: Page number, don't pass for first page, pass \"2\" for second page, and so on", "title": "Page", "type": [ "string", "null" ] }, "description": "Page number; omit for the first page, pass 2 for the second page\n\nUsage: Page number, don't pass for first page, pass \"2\" for second page, and so on" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:8f21eea1e5bab4ab55157758cf5bd95ced440cdb952ccdc753d69f4268e2cb7e" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-app-fetch_home_recommend_feed" } }, "/apis/v1/tikhub/weibo/app/fetch_hot_search": { "get": { "description": "Weibo (app).\n\n### Purpose:\n- Get Weibo hot search ranking, supports multiple categories.\n### Parameters:\n- category: Hot search category\n - mineband: My hot search\n - realtimehot: Realtime hot search (default)\n - social: Social hot search\n - fun: Entertainment hot search\n - technologynav: Technology hot search\n - lifenav: Life hot search\n - region: Local hot search (use region_name to specify city)\n - sportnav: Sports hot search\n - gamenav: ACG hot search\n- page: Page number, starts from 1 (default 1)\n- count: Items per page, default 20, max 50\n- region_name: City name for local hot search, only effective when category=region, default Beijing\n### Return:\n- Hot search ranking data, including search terms, popularity, etc.\n### Note:\n- Hot search ranking updates in real-time\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_app_fetch_hot_search", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Hot search ranking data, including search terms, popularity, etc.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_hot_search", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "b9a3ed5ef723" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/app/fetch_hot_search", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_app_fetch_hot_search", "method": "GET", "path": "/apis/v1/tikhub/weibo/app/fetch_hot_search" }, "parameters": [ { "name": "category", "in": "query", "required": false, "schema": { "type": "string", "description": "Hot search category: mineband=Mine, realtimehot=Hot Search, social=Society, fun=Entertainment, technologynav=Technology, lifenav=Lifestyle, region=Local, sportnav=Sports, gamenav=ACG\n\nUsage: Hot search category\n - mineband: My hot search\n - realtimehot: Realtime hot search (default)\n - social: Social hot search\n - fun: Entertainment hot search\n - technologynav: Technology hot search\n - lifenav: Life hot search\n - region: Local hot search (use region_name to specify city)\n - sportnav: Sports hot search\n - gamenav: ACG hot search", "default": "realtimehot", "title": "Category" }, "description": "Hot search category: mineband=Mine, realtimehot=Hot Search, social=Society, fun=Entertainment, technologynav=Technology, lifenav=Lifestyle, region=Local, sportnav=Sports, gamenav=ACG\n\nUsage: Hot search category\n - mineband: My hot search\n - realtimehot: Realtime hot search (default)\n - social: Social hot search\n - fun: Entertainment hot search\n - technologynav: Technology hot search\n - lifenav: Life hot search\n - region: Local hot search (use region_name to specify city)\n - sportnav: Sports hot search\n - gamenav: ACG hot search", "example": "realtimehot" }, { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 50, "minimum": 1, "description": "Items per page, default 20, max 50", "default": 20, "title": "Count" }, "description": "Items per page, default 20, max 50", "example": 20 }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "description": "Page number, starts from 1 (default 1)", "default": 1, "title": "Page" }, "description": "Page number, starts from 1 (default 1)", "example": 1 }, { "name": "region_name", "in": "query", "required": false, "schema": { "type": "string", "description": "City name for local trending searches, used only when category=region. Pass the original Chinese city name, for example \"北京\" (Beijing, the default). Supported cities include Beijing, Shanghai, Guangzhou, Shenzhen, Hangzhou, Chengdu, Chongqing, Wuhan, Nanjing, Tianjin, Xi'an, Changsha, Zhengzhou, Suzhou, Dongguan, Qingdao, Shenyang, and Hefei.", "title": "Region Name" }, "description": "City name for local trending searches, used only when category=region. Pass the original Chinese city name, for example \"北京\" (Beijing, the default). Supported cities include Beijing, Shanghai, Guangzhou, Shenzhen, Hangzhou, Chengdu, Chongqing, Wuhan, Nanjing, Tianjin, Xi'an, Changsha, Zhengzhou, Suzhou, Dongguan, Qingdao, Shenyang, and Hefei.", "example": "北京" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:5c440739d97c28b5908ba905ecaab9c729bc6fdff1d3a6b4c91310f334b5ff12" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-app-fetch_hot_search" } }, "/apis/v1/tikhub/weibo/app/fetch_hot_search_brief": { "get": { "description": "Weibo (app).\n\n### Purpose\n- Get the Weibo hot search brief (daily hot event digest), returning an AI-generated summary of\n the day's hot events. Each event contains a title, summary, hot search stats\n (including rank appearances and time at the top of the trending list) and source posts.\n\n### Parameters\n- None\n\n### Return\n- Hot search brief data (raw Weibo response). The brief is nested inside the AI search card:\n - items[].data.wboxParam.analysis_result: JSON string, needs to be deserialized first\n - analysis_result.msg: markdown text containing a ```wbCustomBlock code block\n - data.event_list of that code block's JSON (its type is \"hotQuickReport\"): array of the\n day's hot events\n - analysis_result.hot_brief_data: JSON string; once deserialized, slogan_info holds the\n brief title and its update time\n\n### Note\n- The brief is generated by Weibo AI search and is refreshed periodically; see\n slogan_info.dynamic_wenan for the update time\n- Returns about 20 hot events for the current day; this endpoint does not support pagination\n- The brief is a multi-level nested JSON string, callers need to deserialize it level by level\n- The brief is generated progressively by the AI; the server automatically retries when it hits an\n in-progress response. In rare cases an in-progress response is still returned, in which case\n analysis_result.chat_status_stage is not 0 and msg only holds the AI generation trace\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_app_fetch_hot_search_brief", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Hot search brief data (raw Weibo response). The brief is nested inside the AI search card:\n - items[].data.wboxParam.analysis_result: JSON string, needs to be deserialized first\n - analysis_result.msg: markdown text containing a ```wbCustomBlock code block\n - data.event_list of that code block's JSON (its type is \"hotQuickReport\"): array of the\n day's hot events\n - analysis_result.hot_brief_data: JSON string; once deserialized, slogan_info holds the\n brief title and its update time", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_hot_search_brief", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "77f480db49fc" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/app/fetch_hot_search_brief", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_app_fetch_hot_search_brief", "method": "GET", "path": "/apis/v1/tikhub/weibo/app/fetch_hot_search_brief" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:d6d86d317645fcf603902c3f0339a638f26b91cc5b1c197f7e75cf3c4ba622d4" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-app-fetch_hot_search_brief" } }, "/apis/v1/tikhub/weibo/app/fetch_hot_search_categories": { "get": { "description": "Weibo (app).\n\n### Purpose:\n- Get all available hot search category list from Weibo.\n### Parameters:\n- None\n### Return:\n- Hot search category list data, including category names and identifiers\n### Note:\n- Returned categories can be used for category parameter in fetch_hot_search endpoint\n\nAPI references: `fetch_hot_search` = `GET /tikhub/weibo/app/fetch_hot_search` (operationId: `get_tikhub_weibo_app_fetch_hot_search`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_app_fetch_hot_search_categories", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Hot search category list data, including category names and identifiers", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_hot_search_categories", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "0fa717284ca8" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/app/fetch_hot_search_categories", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_app_fetch_hot_search_categories", "method": "GET", "path": "/apis/v1/tikhub/weibo/app/fetch_hot_search_categories" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:3786fd9dfb6bc481465eb530f4b94dac7e5c55892f2f508f55b2aa7cd8adf6db" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-app-fetch_hot_search_categories" } }, "/apis/v1/tikhub/weibo/app/fetch_search_all": { "get": { "description": "Weibo (app).\n\n### Purpose:\n- Comprehensive search in Weibo, return related content. Supports multiple search types.\n### Parameters:\n- query: Search keyword (required)\n- page: Page number, starts from 1 (default 1)\n- search_type: Search type\n - 1: General/All (default)\n - 61: Realtime\n - 3: Users\n - 64: Videos\n - 63: Images\n - 62: Following\n - 60: Hot\n - 21: Whole network\n - 38: Topics\n - 98: Super topics\n - 92: Places/Locations\n - 97: Products/Goods\n### Return:\n- Search result list, including post content, author info, images, videos, etc.\n### Note:\n- Search results sorted by relevance\n- Only use page parameter for pagination\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_app_fetch_search_all", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Search result list, including post content, author info, images, videos, etc.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_search_all", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "d583fee6c238" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/app/fetch_search_all", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_app_fetch_search_all", "method": "GET", "path": "/apis/v1/tikhub/weibo/app/fetch_search_all" }, "parameters": [ { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "description": "Page number, starts from 1 (default 1)", "default": 1, "title": "Page" }, "description": "Page number, starts from 1 (default 1)", "example": 1 }, { "name": "query", "in": "query", "required": true, "schema": { "type": "string", "description": "Search keyword", "title": "Query" }, "description": "Search keyword", "example": "NVIDIA" }, { "name": "search_type", "in": "query", "required": false, "schema": { "type": "integer", "description": "Search type: 1=comprehensive, 61=real-time, 3=user, 64=video, 63=image, 62=following, 60=trending, 21=entire network, 38=topic, 98=super topic, 92=location, 97=product\n\nUsage: Search type\n - 1: General/All (default)\n - 61: Realtime\n - 3: Users\n - 64: Videos\n - 63: Images\n - 62: Following\n - 60: Hot\n - 21: Whole network\n - 38: Topics\n - 98: Super topics\n - 92: Places/Locations\n - 97: Products/Goods", "default": 1, "title": "Search Type" }, "description": "Search type: 1=comprehensive, 61=real-time, 3=user, 64=video, 63=image, 62=following, 60=trending, 21=entire network, 38=topic, 98=super topic, 92=location, 97=product\n\nUsage: Search type\n - 1: General/All (default)\n - 61: Realtime\n - 3: Users\n - 64: Videos\n - 63: Images\n - 62: Following\n - 60: Hot\n - 21: Whole network\n - 38: Topics\n - 98: Super topics\n - 92: Places/Locations\n - 97: Products/Goods", "example": 1 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:ba584958e4f2456d9751a4c93e38cb28d47e49d9eb9cbdee7dbd9ad10c58b44a" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/weibo/app/fetch_search_all?page=1&query=NVIDIA&search_type=1' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-app-fetch_search_all" } }, "/apis/v1/tikhub/weibo/app/fetch_status_comments": { "get": { "description": "Weibo (app).\n\n### Purpose:\n- Get the first-level comment list of specified post (also works for video comments).\n### Parameters:\n- status_id: Post ID or Video ID (required)\n- max_id: Pagination cursor, don't pass for first request, use returned max_id for subsequent requests\n - max_id json path: $.data.moreInfo.params.max_id\n- sort_type: Comment sort type\n - 0: Sort by popularity (default)\n - 1: Sort by time\n### Return:\n- Comment list data, including comment content, commenter info, likes count, etc.\n- Contains max_id field for pagination\n### Note:\n- About 20 comments per page\n- When no more comments, max_id is empty or same\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_app_fetch_status_comments", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Comment list data, including comment content, commenter info, likes count, etc.\n- Contains max_id field for pagination", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_status_comments", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "7a3536f4febf" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/app/fetch_status_comments", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_app_fetch_status_comments", "method": "GET", "path": "/apis/v1/tikhub/weibo/app/fetch_status_comments" }, "parameters": [ { "name": "max_id", "in": "query", "required": false, "schema": { "description": "Pagination cursor, don't pass for first request, use returned max_id for subsequent requests\n - max_id json path: $.data.moreInfo.params.max_id", "title": "Max Id", "type": [ "string", "null" ] }, "description": "Pagination cursor, don't pass for first request, use returned max_id for subsequent requests\n - max_id json path: $.data.moreInfo.params.max_id" }, { "name": "sort_type", "in": "query", "required": false, "schema": { "type": "string", "description": "Sort type: 0=by popularity, 1=by time\n\nUsage: Comment sort type\n - 0: Sort by popularity (default)\n - 1: Sort by time", "default": "0", "title": "Sort Type" }, "description": "Sort type: 0=by popularity, 1=by time\n\nUsage: Comment sort type\n - 0: Sort by popularity (default)\n - 1: Sort by time", "example": "0" }, { "name": "status_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Weibo ID\n\nUsage: Post ID or Video ID (required)", "title": "Status Id" }, "description": "Weibo ID\n\nUsage: Post ID or Video ID (required)", "example": "5258708168476831" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:0b7f90281d034459ff7936d5d8b39bea5d78016b16c1a50afd822e324df163de" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/weibo/app/fetch_status_comments?sort_type=0&status_id=5258708168476831' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-app-fetch_status_comments" } }, "/apis/v1/tikhub/weibo/app/fetch_status_detail": { "get": { "description": "Weibo (app).\n\n### Purpose:\n- Get detailed information of specified post.\n### Parameters:\n- status_id: Post ID (required)\n### Return:\n- Post detailed data, including full text, images, videos, likes, comments, reposts count, etc.\n### Note:\n- May not be available if post has been deleted or set to private\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_app_fetch_status_detail", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Post detailed data, including full text, images, videos, likes, comments, reposts count, etc.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_status_detail", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "55e6b3f204bf" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/app/fetch_status_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_app_fetch_status_detail", "method": "GET", "path": "/apis/v1/tikhub/weibo/app/fetch_status_detail" }, "parameters": [ { "name": "status_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Weibo ID", "title": "Status Id" }, "description": "Weibo ID", "example": "5016922058656962" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:90633c49506396ea1dca1883741a28f71683fd1f24a7c4f80857ed72d25b049b" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/weibo/app/fetch_status_detail?status_id=5016922058656962' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-app-fetch_status_detail" } }, "/apis/v1/tikhub/weibo/app/fetch_status_likes": { "get": { "description": "Weibo (app).\n\n### Purpose:\n- Get the like list of specified post (also works for video likes).\n### Parameters:\n- status_id: Post ID or Video ID (required)\n- attitude_type: Like type filter\n - 0: All (default)\n - 1: Like\n - 2: Happy\n - 3: Surprise\n - 4: Sad\n - 5: Angry\n - 6: Reward\n - 8: Hug\n### Return:\n- Like list data, including liker info, like type, etc.\n### Note:\n- About 50 likes per page\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_app_fetch_status_likes", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Like list data, including liker info, like type, etc.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_status_likes", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "cb645927289b" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/app/fetch_status_likes", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_app_fetch_status_likes", "method": "GET", "path": "/apis/v1/tikhub/weibo/app/fetch_status_likes" }, "parameters": [ { "name": "attitude_type", "in": "query", "required": false, "schema": { "type": "string", "description": "Reaction type: 0=All, 1=Like, 2=Happy, 3=Surprised, 4=Sad, 5=Angry, 6=Tip, 8=Hug\n\nUsage: Like type filter\n - 0: All (default)\n - 1: Like\n - 2: Happy\n - 3: Surprise\n - 4: Sad\n - 5: Angry\n - 6: Reward\n - 8: Hug", "default": "0", "title": "Attitude Type" }, "description": "Reaction type: 0=All, 1=Like, 2=Happy, 3=Surprised, 4=Sad, 5=Angry, 6=Tip, 8=Hug\n\nUsage: Like type filter\n - 0: All (default)\n - 1: Like\n - 2: Happy\n - 3: Surprise\n - 4: Sad\n - 5: Angry\n - 6: Reward\n - 8: Hug", "example": "0" }, { "name": "status_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Weibo ID\n\nUsage: Post ID or Video ID (required)", "title": "Status Id" }, "description": "Weibo ID\n\nUsage: Post ID or Video ID (required)", "example": "5016922058656962" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:67b3c2c429a059d32bf548218c050b0aed8e9a79430a0b46b998b29d6c864b63" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/weibo/app/fetch_status_likes?attitude_type=0&status_id=5016922058656962' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-app-fetch_status_likes" } }, "/apis/v1/tikhub/weibo/app/fetch_status_reposts": { "get": { "description": "Weibo (app).\n\n### Purpose:\n- Get the repost list of specified post (also works for video reposts).\n### Parameters:\n- status_id: Post ID or Video ID (required)\n- max_id: Pagination cursor, don't pass for first request, use returned max_id for subsequent requests\n### Return:\n- Repost list data, including repost content, reposter info, etc.\n- Contains max_id field for pagination\n### Note:\n- About 20 reposts per page\n- When no more reposts, max_id is empty or same\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_app_fetch_status_reposts", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Repost list data, including repost content, reposter info, etc.\n- Contains max_id field for pagination", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_status_reposts", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "7d6b8806206b" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/app/fetch_status_reposts", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_app_fetch_status_reposts", "method": "GET", "path": "/apis/v1/tikhub/weibo/app/fetch_status_reposts" }, "parameters": [ { "name": "max_id", "in": "query", "required": false, "schema": { "description": "Pagination cursor, don't pass for first request, use returned max_id for subsequent requests", "title": "Max Id", "type": [ "string", "null" ] }, "description": "Pagination cursor, don't pass for first request, use returned max_id for subsequent requests" }, { "name": "status_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Weibo ID\n\nUsage: Post ID or Video ID (required)", "title": "Status Id" }, "description": "Weibo ID\n\nUsage: Post ID or Video ID (required)", "example": "5016922058656962" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:b04854607caa714dc7c63e72f69ff926258d368e8b95e299e06bf7942e5ec362" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/weibo/app/fetch_status_reposts?status_id=5016922058656962' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-app-fetch_status_reposts" } }, "/apis/v1/tikhub/weibo/app/fetch_user_album": { "get": { "description": "Weibo (app).\n\n### Purpose:\n- Get the album content of specified user.\n### Parameters:\n- uid: User ID (required)\n- since_id: Pagination cursor, don't pass for first request, use returned since_id for subsequent requests\n### Return:\n- User album data, including image list, etc.\n### Note:\n- If user has set privacy protection, album may not be available\n- Uses cursor pagination (since_id), not page numbers\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_app_fetch_user_album", "responses": { "200": { "description": "Successful Response\n\n### Return\n- User album data, including image list, etc.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_user_album", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "156b5868a497" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/app/fetch_user_album", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_app_fetch_user_album", "method": "GET", "path": "/apis/v1/tikhub/weibo/app/fetch_user_album" }, "parameters": [ { "name": "since_id", "in": "query", "required": false, "schema": { "description": "Pagination cursor, don't pass for first request, use returned since_id for subsequent requests", "title": "Since Id", "type": [ "string", "null" ] }, "description": "Pagination cursor, don't pass for first request, use returned since_id for subsequent requests" }, { "name": "uid", "in": "query", "required": true, "schema": { "type": "string", "description": "User ID", "title": "Uid" }, "description": "User ID", "example": "7648703289" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:c03a748733085312e2614494b34bf75f05a09d17ecc40d02e69991bd78ba5cf0" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/weibo/app/fetch_user_album?uid=7648703289' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-app-fetch_user_album" } }, "/apis/v1/tikhub/weibo/app/fetch_user_articles": { "get": { "description": "Weibo (app).\n\n### Purpose:\n- Get the article list published by specified user.\n### Parameters:\n- uid: User ID (required)\n- since_id: Pagination cursor, don't pass for first request, use returned since_id for subsequent requests\n### Return:\n- User article list data\n### Note:\n- If user has not published any articles, returns empty list\n- Uses cursor pagination (since_id), not page numbers\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_app_fetch_user_articles", "responses": { "200": { "description": "Successful Response\n\n### Return\n- User article list data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_user_articles", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "f05b3a1792ea" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/app/fetch_user_articles", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_app_fetch_user_articles", "method": "GET", "path": "/apis/v1/tikhub/weibo/app/fetch_user_articles" }, "parameters": [ { "name": "since_id", "in": "query", "required": false, "schema": { "description": "Pagination cursor, don't pass for first request, use returned since_id for subsequent requests", "title": "Since Id", "type": [ "string", "null" ] }, "description": "Pagination cursor, don't pass for first request, use returned since_id for subsequent requests" }, { "name": "uid", "in": "query", "required": true, "schema": { "type": "string", "description": "User ID", "title": "Uid" }, "description": "User ID", "example": "1725941200" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:64b770a0e54d8e0514f9dafd87b85ed33d8905077e59ec01d8d81a8e53f4407c" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/weibo/app/fetch_user_articles?uid=1725941200' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-app-fetch_user_articles" } }, "/apis/v1/tikhub/weibo/app/fetch_user_audios": { "get": { "description": "Weibo (app).\n\n### Purpose:\n- Get the audio list published by specified user.\n### Parameters:\n- uid: User ID (required)\n- since_id: Pagination cursor, don't pass for first request, use returned since_id for subsequent requests\n### Return:\n- User audio list data\n### Note:\n- If user has not published any audios, returns empty list\n- Uses cursor pagination (since_id), not page numbers\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_app_fetch_user_audios", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- User audio list data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_user_audios", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "724a683ecc99" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/app/fetch_user_audios", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_app_fetch_user_audios", "method": "GET", "path": "/apis/v1/tikhub/weibo/app/fetch_user_audios" }, "parameters": [ { "name": "since_id", "in": "query", "required": false, "schema": { "description": "Pagination cursor, don't pass for first request, use returned since_id for subsequent requests", "title": "Since Id", "type": [ "string", "null" ] }, "description": "Pagination cursor, don't pass for first request, use returned since_id for subsequent requests" }, { "name": "uid", "in": "query", "required": true, "schema": { "type": "string", "description": "User ID", "title": "Uid" }, "description": "User ID", "example": "1725941200" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:69909e32193cdf23802fbd1a3d81f2207f81dfc07435e09f588dfc3757eb32fc" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/weibo/app/fetch_user_audios?uid=1725941200' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-app-fetch_user_audios" } }, "/apis/v1/tikhub/weibo/app/fetch_user_followers": { "get": { "description": "Weibo (app).\n\n### Purpose:\n- Get the followers (fans) list of the specified user, returning follower profiles\n (nickname, avatar, bio, followers count, latest post, etc.).\n### Parameters:\n- uid: User ID (required)\n- page: Page number, starting from 1 (default 1)\n### Return:\n- Followers list data\n - data.list.users: Array of follower users\n - data.list.next_page: Next page number, None or 0 when there is no more data\n - data.list.display_total_number: Total followers count\n### Note:\n- This endpoint uses the Weibo mobile (m.weibo.cn) H5 API and relies on the server-side\n cached logged-in cookie; an expired cookie results in an error\n- Paginate by incrementing `page`; there is no more data once `data.list.next_page` is empty or 0\n- Each page returns 20 items. Weibo filters out some accounts (blogger self-protection\n strategy), so the actual number of items in a page may be less than 20\n- Weibo limits the pagination depth of the followers list (in practice `users` becomes an empty\n array and `next_page` becomes 0 after roughly 1000 records)\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_app_fetch_user_followers", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Followers list data\n - data.list.users: Array of follower users\n - data.list.next_page: Next page number, None or 0 when there is no more data\n - data.list.display_total_number: Total followers count", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_user_followers", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "d1bca43bb08c" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/app/fetch_user_followers", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_app_fetch_user_followers", "method": "GET", "path": "/apis/v1/tikhub/weibo/app/fetch_user_followers" }, "parameters": [ { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "description": "Page number, starting from 1 (default 1)", "default": 1, "title": "Page" }, "description": "Page number, starting from 1 (default 1)", "example": 1 }, { "name": "uid", "in": "query", "required": true, "schema": { "type": "string", "description": "User ID", "title": "Uid" }, "description": "User ID", "example": "1856404484" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:cf2c834e1fa8c2ffa279618874c3de75d487e478d4f21803d393596b42d03caf" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/weibo/app/fetch_user_followers?page=1&uid=1856404484' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-app-fetch_user_followers" } }, "/apis/v1/tikhub/weibo/app/fetch_user_following": { "get": { "description": "Weibo (app).\n\n### Purpose\n- Get the following list of the specified user, returning the profiles of followed users\n (nickname, avatar, bio, followers count, latest post, etc.).\n\n### Parameters\n- uid: User ID (required)\n- since_id: Pagination cursor in \"timestamp|offset\" format. Don't pass for the first request,\n use the returned since_id for subsequent requests\n - since_id json path: $.data.since_id\n- sort_type: Sort type\n - 1: Sort by latest post time in descending order (recently posted first)\n - 2: Sort by following time in descending order (recently followed first, default)\n\n### Return\n- Following list data\n - data.users: Array of followed users, each item holds the profile in its `user` field\n (data.users[].user)\n - data.since_id: Next pagination cursor, absent when there is no more data\n - data.total_cnt: Total following count\n\n### Note\n- This endpoint uses the Weibo mobile (m.weibo.cn) H5 API and relies on the server-side\n cached logged-in cookie; an expired cookie results in an error\n- About 20 items per page. Uses cursor pagination (since_id), not page numbers\n- The absence of since_id in the response means the end of the list has been reached; that last\n response may still carry a final batch of fewer than 20 items\n- User profiles are nested under data.users[].user, which differs from the followers endpoint\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_app_fetch_user_following", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Following list data\n - data.users: Array of followed users, each item holds the profile in its `user` field\n (data.users[].user)\n - data.since_id: Next pagination cursor, absent when there is no more data\n - data.total_cnt: Total following count", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_user_following", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "7ba80eaa0a81" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/app/fetch_user_following", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_app_fetch_user_following", "method": "GET", "path": "/apis/v1/tikhub/weibo/app/fetch_user_following" }, "parameters": [ { "name": "since_id", "in": "query", "required": false, "schema": { "description": "Pagination cursor in the format \"timestamp|offset\"; omit for the first request, then pass the since_id value from the previous response\n\nUsage: Pagination cursor in \"timestamp|offset\" format. Don't pass for the first request,\n use the returned since_id for subsequent requests\n - since_id json path: $.data.since_id", "title": "Since Id", "type": [ "string", "null" ] }, "description": "Pagination cursor in the format \"timestamp|offset\"; omit for the first request, then pass the since_id value from the previous response\n\nUsage: Pagination cursor in \"timestamp|offset\" format. Don't pass for the first request,\n use the returned since_id for subsequent requests\n - since_id json path: $.data.since_id" }, { "name": "sort_type", "in": "query", "required": false, "schema": { "type": "integer", "description": "Sort type: 1=by latest Weibo time, 2=by follow time (default)\n\nUsage: Sort type\n - 1: Sort by latest post time in descending order (recently posted first)\n - 2: Sort by following time in descending order (recently followed first, default)", "default": 2, "title": "Sort Type" }, "description": "Sort type: 1=by latest Weibo time, 2=by follow time (default)\n\nUsage: Sort type\n - 1: Sort by latest post time in descending order (recently posted first)\n - 2: Sort by following time in descending order (recently followed first, default)", "example": 2 }, { "name": "uid", "in": "query", "required": true, "schema": { "type": "string", "description": "User ID", "title": "Uid" }, "description": "User ID", "example": "1856404484" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:d8770b54cb8a16433065d6138acef3920aa998919c2229a27ed085d73ec69bad" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/weibo/app/fetch_user_following?sort_type=2&uid=1856404484' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-app-fetch_user_following" } }, "/apis/v1/tikhub/weibo/app/fetch_user_info": { "get": { "description": "Weibo (app).\n\n### Purpose:\n- Get basic information of Weibo users, including nickname, avatar, bio, following count, followers count, etc.\n### Parameters:\n- uid: User ID (required)\n### Return:\n- User basic information data\n### Note:\n- Some information may not be available if user has set privacy protection\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_app_fetch_user_info", "responses": { "200": { "description": "Successful Response\n\n### Return\n- User basic information data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_user_info", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "dc996c61fd64" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/app/fetch_user_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_app_fetch_user_info", "method": "GET", "path": "/apis/v1/tikhub/weibo/app/fetch_user_info" }, "parameters": [ { "name": "uid", "in": "query", "required": true, "schema": { "type": "string", "description": "User ID", "title": "Uid" }, "description": "User ID", "example": "7648703289" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:3ec1f63a4275eb42674b7315e3d2827733e673e1663f349c6ed7b0e3f4791bdf" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/weibo/app/fetch_user_info?uid=7648703289' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-app-fetch_user_info" } }, "/apis/v1/tikhub/weibo/app/fetch_user_info_detail": { "get": { "description": "Weibo (app).\n\n### Purpose:\n- Get detailed information of Weibo users, more complete than basic info, including verification info, tags, level, etc.\n### Parameters:\n- uid: User ID (required)\n### Return:\n- User detailed information data\n### Note:\n- Some information may not be available if user has set privacy protection\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_app_fetch_user_info_detail", "responses": { "200": { "description": "Successful Response\n\n### Return\n- User detailed information data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_user_info_detail", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "99f7b178a4ca" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/app/fetch_user_info_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_app_fetch_user_info_detail", "method": "GET", "path": "/apis/v1/tikhub/weibo/app/fetch_user_info_detail" }, "parameters": [ { "name": "uid", "in": "query", "required": true, "schema": { "type": "string", "description": "User ID", "title": "Uid" }, "description": "User ID", "example": "7648703289" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:b6dd380c50f2cc52742811d806b5219beeb5c574ff655058ccc6ada986e1cfd7" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/weibo/app/fetch_user_info_detail?uid=7648703289' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-app-fetch_user_info_detail" } }, "/apis/v1/tikhub/weibo/app/fetch_user_profile_feed": { "get": { "description": "Weibo (app).\n\n### Purpose:\n- Get the profile feed of specified user.\n### Parameters:\n- uid: User ID (required)\n- since_id: Pagination cursor, don't pass for first request, use returned since_id for subsequent requests\n### Return:\n- User profile feed data\n### Note:\n- If user has set privacy protection, feed may not be available\n- Uses cursor pagination (since_id), not page numbers\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_app_fetch_user_profile_feed", "responses": { "200": { "description": "Successful Response\n\n### Return\n- User profile feed data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_user_profile_feed", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "f32034175a5a" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/app/fetch_user_profile_feed", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_app_fetch_user_profile_feed", "method": "GET", "path": "/apis/v1/tikhub/weibo/app/fetch_user_profile_feed" }, "parameters": [ { "name": "since_id", "in": "query", "required": false, "schema": { "description": "Pagination cursor, don't pass for first request, use returned since_id for subsequent requests", "title": "Since Id", "type": [ "string", "null" ] }, "description": "Pagination cursor, don't pass for first request, use returned since_id for subsequent requests" }, { "name": "uid", "in": "query", "required": true, "schema": { "type": "string", "description": "User ID", "title": "Uid" }, "description": "User ID", "example": "6580994757" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:d11cca6744e20f0ead278327a1dc0d8299539f45eb611b59c01853232d25c062" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/weibo/app/fetch_user_profile_feed?uid=6580994757' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-app-fetch_user_profile_feed" } }, "/apis/v1/tikhub/weibo/app/fetch_user_super_topics": { "get": { "description": "Weibo (app).\n\n### Purpose:\n- Get the super topics list that user participated in.\n### Parameters:\n- uid: User ID (required)\n- page: Page number, starts from 1 (default 1)\n### Return:\n- User's super topics list data\n### Note:\n- If user has set privacy protection, super topics list may not be available\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_app_fetch_user_super_topics", "responses": { "200": { "description": "Successful Response\n\n### Return\n- User's super topics list data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_user_super_topics", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "952684d0c741" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/app/fetch_user_super_topics", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_app_fetch_user_super_topics", "method": "GET", "path": "/apis/v1/tikhub/weibo/app/fetch_user_super_topics" }, "parameters": [ { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "description": "Page number, starts from 1 (default 1)", "default": 1, "title": "Page" }, "description": "Page number, starts from 1 (default 1)", "example": 1 }, { "name": "uid", "in": "query", "required": true, "schema": { "type": "string", "description": "User ID", "title": "Uid" }, "description": "User ID", "example": "7648703289" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:308c31bb2c11131379d4046bbc4ffd270a15db4c1bf7f2e28641b3a00191a5d9" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/weibo/app/fetch_user_super_topics?page=1&uid=7648703289' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-app-fetch_user_super_topics" } }, "/apis/v1/tikhub/weibo/app/fetch_user_timeline": { "get": { "description": "Weibo (app).\n\n### Purpose:\n- Get the list of posts published by specified user, support pagination and multiple content filters.\n### Parameters:\n- uid: User ID (required)\n- page: Page number, starts from 1 (default 1)\n- filter_type: Filter type (default \"all\")\n - all: All posts\n - original: Original posts\n - likes: Liked posts\n - video: Video posts\n - pic: Picture posts\n - location: Location check-in posts\n - month: Filter by time (must pass month parameter)\n- month: Time filter parameter, format YYYYMMDD (only used when filter_type=month)\n### Return:\n- Post list data, including post content, images, videos, etc.\n### Note:\n- If user has set privacy protection, post list may not be available\n- About 20 posts per page\n- When using time filter, must specify both filter_type=month and month parameter\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_app_fetch_user_timeline", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Post list data, including post content, images, videos, etc.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_user_timeline", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "c39137a54524" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/app/fetch_user_timeline", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_app_fetch_user_timeline", "method": "GET", "path": "/apis/v1/tikhub/weibo/app/fetch_user_timeline" }, "parameters": [ { "name": "filter_type", "in": "query", "required": false, "schema": { "type": "string", "description": "Filter type (default \"all\")\n - all: All posts\n - original: Original posts\n - likes: Liked posts\n - video: Video posts\n - pic: Picture posts\n - location: Location check-in posts\n - month: Filter by time (must pass month parameter)", "default": "all", "title": "Filter Type" }, "description": "Filter type (default \"all\")\n - all: All posts\n - original: Original posts\n - likes: Liked posts\n - video: Video posts\n - pic: Picture posts\n - location: Location check-in posts\n - month: Filter by time (must pass month parameter)", "example": "all" }, { "name": "month", "in": "query", "required": false, "schema": { "description": "Time filter parameter, format YYYYMMDD (only used when filter_type=month)", "title": "Month", "type": [ "string", "null" ] }, "description": "Time filter parameter, format YYYYMMDD (only used when filter_type=month)", "example": "20251010" }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "description": "Page number, starts from 1 (default 1)", "default": 1, "title": "Page" }, "description": "Page number, starts from 1 (default 1)", "example": 1 }, { "name": "uid", "in": "query", "required": true, "schema": { "type": "string", "description": "User ID", "title": "Uid" }, "description": "User ID", "example": "7648703289" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:16b04c64628fe326bd51144953c76d96cee6b3d0be762c21ca3d66700d28220d" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/weibo/app/fetch_user_timeline?filter_type=all&month=20251010&page=1&uid=7648703289' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-app-fetch_user_timeline" } }, "/apis/v1/tikhub/weibo/app/fetch_user_videos": { "get": { "description": "Weibo (app).\n\n### Purpose:\n- Get the video list published by specified user (waterfall layout).\n### Parameters:\n- uid: User ID (required)\n- since_id: Pagination cursor, don't pass for first request, use returned since_id for subsequent requests\n### Return:\n- Video list data, including video title, cover, views, etc.\n- Contains moreInfo.params.since_id field for pagination\n### Note:\n- Only returns posts with videos\n- Uses cursor pagination (since_id), not page numbers\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_app_fetch_user_videos", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Video list data, including video title, cover, views, etc.\n- Contains moreInfo.params.since_id field for pagination", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_user_videos", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "ecd961b933e8" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/app/fetch_user_videos", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_app_fetch_user_videos", "method": "GET", "path": "/apis/v1/tikhub/weibo/app/fetch_user_videos" }, "parameters": [ { "name": "since_id", "in": "query", "required": false, "schema": { "description": "Pagination cursor, don't pass for first request, use returned since_id for subsequent requests", "title": "Since Id", "type": [ "string", "null" ] }, "description": "Pagination cursor, don't pass for first request, use returned since_id for subsequent requests" }, { "name": "uid", "in": "query", "required": true, "schema": { "type": "string", "description": "User ID", "title": "Uid" }, "description": "User ID", "example": "7648703289" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:a225084e563812396a6a4379677911832ee1fadc5ef1745a1a2f30fab8b458fe" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/weibo/app/fetch_user_videos?uid=7648703289' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-app-fetch_user_videos" } }, "/apis/v1/tikhub/weibo/app/fetch_video_detail": { "get": { "description": "Weibo (app).\n\n### Purpose:\n- Get detailed information of single video, including video play URL.\n- **Important**: Required step to get real video ID from Weibo video link (e.g., https://weibo.com/tv/show/1034:5232127105761312)\n### Parameters:\n- mid: Video post ID or ID from link (required)\n### Return:\n- Video detailed data, including video play URL, cover, duration, title, etc.\n- **items[0].data.idstr**: Real video post ID, can be used for fetching comments\n### Note:\n- Returned video URL may have expiration time\n- Support getting HD video URL\n- **Must call this API before fetching comments**: ID from link cannot be used directly for comments, must get real ID from items[0].data.idstr first\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_app_fetch_video_detail", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Video detailed data, including video play URL, cover, duration, title, etc.\n- **items[0].data.idstr**: Real video post ID, can be used for fetching comments", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_video_detail", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "0802da4744d5" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/app/fetch_video_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_app_fetch_video_detail", "method": "GET", "path": "/apis/v1/tikhub/weibo/app/fetch_video_detail" }, "parameters": [ { "name": "mid", "in": "query", "required": true, "schema": { "type": "string", "description": "Weibo video ID\n\nUsage: Video post ID or ID from link (required)", "title": "Mid" }, "description": "Weibo video ID\n\nUsage: Video post ID or ID from link (required)", "example": "5242977759006596" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:11dc18042caa1288b97dbbdbe5e6a41476029a49eec6165597fbbb40f956e197" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/weibo/app/fetch_video_detail?mid=5242977759006596' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-app-fetch_video_detail" } }, "/apis/v1/tikhub/weibo/app/fetch_video_featured_feed": { "get": { "description": "Weibo (app).\n\n### Purpose:\n- Get the featured video feed from Weibo video section.\n### Parameters:\n- page: Page number, don't pass for first page, pass \"2\" for second page, and so on\n### Return:\n- Featured video feed data, including video list, etc.\n### Note:\n- About 20 videos per page\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_app_fetch_video_featured_feed", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Featured video feed data, including video list, etc.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_video_featured_feed", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "7b0809326d79" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/app/fetch_video_featured_feed", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_app_fetch_video_featured_feed", "method": "GET", "path": "/apis/v1/tikhub/weibo/app/fetch_video_featured_feed" }, "parameters": [ { "name": "page", "in": "query", "required": false, "schema": { "description": "Page number; omit for the first page, pass 2 for the second page\n\nUsage: Page number, don't pass for first page, pass \"2\" for second page, and so on", "title": "Page", "type": [ "string", "null" ] }, "description": "Page number; omit for the first page, pass 2 for the second page\n\nUsage: Page number, don't pass for first page, pass \"2\" for second page, and so on" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:825dd1a887677eaa054931b627b43f615342953ef5829f745f09809760375024" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-app-fetch_video_featured_feed" } }, "/apis/v1/tikhub/weibo/web_v2/check_allow_comment_with_pic": { "get": { "description": "Weibo (web_v2).\n\n### Purpose:\n- Check if a specific Weibo post allows image comments.\n### Parameters:\n- id: Weibo post ID (required)\n### Return:\n- result: true means image comments allowed, false means not allowed\n### Note:\n- Different posts may have different image comment permissions\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_web_v2_check_allow_comment_with_pic", "responses": { "200": { "description": "Successful Response\n\n### Return\n- result: true means image comments allowed, false means not allowed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo check_allow_comment_with_pic", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "4662fb4e8202" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/web_v2/check_allow_comment_with_pic", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_web_v2_check_allow_comment_with_pic", "method": "GET", "path": "/apis/v1/tikhub/weibo/web_v2/check_allow_comment_with_pic" }, "parameters": [ { "name": "id", "in": "query", "required": true, "schema": { "type": "string", "description": "Weibo ID", "title": "Id" }, "description": "Weibo ID", "example": "5092682368025584" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:2736b14e0f7fddac3fa6a644eb3dd1de752f0b0796426d7af4a045a770aa62c2" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/weibo/web_v2/check_allow_comment_with_pic?id=5092682368025584' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-web_v2-check_allow_comment_with_pic" } }, "/apis/v1/tikhub/weibo/web_v2/fetch_advanced_search": { "get": { "description": "Weibo (web_v2).\n\n### Purpose:\n- Weibo advanced search with multi-dimensional filtering.\n### Parameters:\n- q: Search keyword (required)\n- search_type: Search type (all/hot/original/verified/media/viewpoint)\n- include_type: Include type (all/pic/video/music/link)\n- timescope: Time scope (format: custom:start_date:end_date, e.g. custom:2025-09-01-0:2025-09-08-23)\n- page: Page number (default 1)\n### Return:\n- Search result list, including post content, author info, images, videos, interaction data\n### Note:\n- Video playback requires setting header Referer=https://weibo.com/\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_web_v2_fetch_advanced_search", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Search result list, including post content, author info, images, videos, interaction data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_advanced_search", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "3cacf41c5802" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/web_v2/fetch_advanced_search", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_web_v2_fetch_advanced_search", "method": "GET", "path": "/apis/v1/tikhub/weibo/web_v2/fetch_advanced_search" }, "parameters": [ { "name": "include_type", "in": "query", "required": false, "schema": { "description": "Include type: all (all), pic (with image), video (with video), music (with music), link (with short link)", "title": "Include Type", "type": [ "string", "null" ] }, "description": "Include type: all (all), pic (with image), video (with video), music (with music), link (with short link)", "example": "pic" }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page number (default 1)", "default": 1, "title": "Page" }, "description": "Page number (default 1)", "example": 1 }, { "name": "q", "in": "query", "required": true, "schema": { "type": "string", "description": "Search keyword", "title": "Q" }, "description": "Search keyword", "example": "yu7" }, { "name": "search_type", "in": "query", "required": false, "schema": { "description": "Search type: all, hot, original, verified, media, viewpoint", "title": "Search Type", "type": [ "string", "null" ] }, "description": "Search type: all, hot, original, verified, media, viewpoint", "example": "hot" }, { "name": "timescope", "in": "query", "required": false, "schema": { "description": "Time scope: custom:start:end\n\nUsage: Time scope (format: custom:start_date:end_date, e.g. custom:2025-09-01-0:2025-09-08-23)", "title": "Timescope", "type": [ "string", "null" ] }, "description": "Time scope: custom:start:end\n\nUsage: Time scope (format: custom:start_date:end_date, e.g. custom:2025-09-01-0:2025-09-08-23)", "example": "custom:2025-09-01-0:2025-09-08-23" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:2fbc31593e96ea343d911650c3f12d9ffda435b8b5d3e0e02f336b8332df4af8" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/weibo/web_v2/fetch_advanced_search?include_type=pic&page=1&q=yu7&search_type=hot×cope=custom%3A2025-09-01-0%3A2025-09-08-23' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-web_v2-fetch_advanced_search" } }, "/apis/v1/tikhub/weibo/web_v2/fetch_ai_related_search": { "get": { "description": "Weibo (web_v2).\n\n### Purpose:\n- Get content extensions related to keyword (related questions, blogger recommendations, reference posts).\n### Parameters:\n- keyword: Search keyword (required, recommend using topic format #TopicName#)\n### Return:\n- HTML format extension content, including related questions, blogger recommendations, reference posts\n### Note:\n- Returned content is in HTML format, requires HTML parsing\n- HTML structure may change, need proper error handling\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_web_v2_fetch_ai_related_search", "responses": { "200": { "description": "Successful Response\n\n### Return\n- HTML format extension content, including related questions, blogger recommendations, reference posts", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_ai_related_search", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "36d3a364c783" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/web_v2/fetch_ai_related_search", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_web_v2_fetch_ai_related_search", "method": "GET", "path": "/apis/v1/tikhub/weibo/web_v2/fetch_ai_related_search" }, "parameters": [ { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Search keyword (required, recommend using topic format #TopicName#)", "title": "Keyword" }, "description": "Search keyword (required, recommend using topic format #TopicName#)", "example": "#WeiboAdventures#" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:3a9fddf0ad2d65907f5fac76dad8735c5436abca1e227e903cdd7e7b090f79bb" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/weibo/web_v2/fetch_ai_related_search?keyword=%23WeiboAdventures%23' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-web_v2-fetch_ai_related_search" } }, "/apis/v1/tikhub/weibo/web_v2/fetch_ai_search": { "get": { "description": "Weibo (web_v2).\n\n### Purpose:\n- Get search results through Weibo AI intelligent search.\n### Parameters:\n- query: Search keyword (required, recommend using topic format #TopicName#)\n### Return:\n- AI search results, including recommended content, related topics\n### Note:\n- AI search results are personalized based on user behavior\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_web_v2_fetch_ai_search", "responses": { "200": { "description": "Successful Response\n\n### Return\n- AI search results, including recommended content, related topics", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_ai_search", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "71cb16661ae1" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/web_v2/fetch_ai_search", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_web_v2_fetch_ai_search", "method": "GET", "path": "/apis/v1/tikhub/weibo/web_v2/fetch_ai_search" }, "parameters": [ { "name": "query", "in": "query", "required": true, "schema": { "type": "string", "description": "Search keyword (required, recommend using topic format #TopicName#)", "title": "Query" }, "description": "Search keyword (required, recommend using topic format #TopicName#)", "example": "#France#" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:79905952c32daf1132bb2ef288b65e998ac941b6bf91138d4e128b50c9903d1a" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/weibo/web_v2/fetch_ai_search?query=%23France%23' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-web_v2-fetch_ai_search" } }, "/apis/v1/tikhub/weibo/web_v2/fetch_all_groups": { "get": { "description": "Weibo (web_v2).\n\n### Purpose:\n- Get all group information on Weibo platform, including default and user-defined groups.\n### Parameters:\n- No additional parameters required\n### Return:\n- Group list, including group ID, name, container ID, etc.\n### Note:\n- Returned gid and containerid can be used as parameters for timeline API\n- Group information changes infrequently, recommend caching\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_web_v2_fetch_all_groups", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Group list, including group ID, name, container ID, etc.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_all_groups", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "394a03ef1ba1" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/web_v2/fetch_all_groups", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_web_v2_fetch_all_groups", "method": "GET", "path": "/apis/v1/tikhub/weibo/web_v2/fetch_all_groups" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:37a940fa3a13a0d2d60ce75e8c76d7ef47238ba11cdaeaac839b93e215c702ea" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-web_v2-fetch_all_groups" } }, "/apis/v1/tikhub/weibo/web_v2/fetch_city_list": { "get": { "description": "Weibo (web_v2).\n\n### Purpose:\n- Get region city mapping data for region filter parameter in user search APIs.\n### Parameters:\n- normalized: Whether to return normalized structure (default True)\n### Return:\n- Province-city mapping data, for region parameter in fetch_user_search and other APIs\n### Note:\n- Returned code format is custom:province_code:city_code, e.g. custom:11:1\n\nAPI references: `fetch_user_search` = `GET /tikhub/weibo/web_v2/fetch_user_search` (operationId: `get_tikhub_weibo_web_v2_fetch_user_search`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_web_v2_fetch_city_list", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Province-city mapping data, for region parameter in fetch_user_search and other APIs\n\nAPI references: `fetch_user_search` = `GET /tikhub/weibo/web_v2/fetch_user_search` (operationId: `get_tikhub_weibo_web_v2_fetch_user_search`).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_city_list", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "3a019ef4f0e8" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/web_v2/fetch_city_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_web_v2_fetch_city_list", "method": "GET", "path": "/apis/v1/tikhub/weibo/web_v2/fetch_city_list" }, "parameters": [ { "name": "normalized", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether to return normalized structure (province list + city array)", "default": true, "title": "Normalized" }, "description": "Whether to return normalized structure (province list + city array)" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:009ac4ec56b4374d07b8084d0924bc3d0fa18a16ad8be865975fb5cb6e52ecb6" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-web_v2-fetch_city_list" } }, "/apis/v1/tikhub/weibo/web_v2/fetch_entertainment_ranking": { "get": { "description": "Weibo (web_v2).\n\n### Purpose:\n- Get Weibo entertainment ranking data (entertainment, film & TV, variety shows).\n### Parameters:\n- No additional parameters required\n### Return:\n- Entertainment topic list, including topic, heat value, rank, category\n### Note:\n- Recommend caching for 5-10 minutes\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_web_v2_fetch_entertainment_ranking", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Entertainment topic list, including topic, heat value, rank, category", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_entertainment_ranking", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "f08569ee1a3f" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/web_v2/fetch_entertainment_ranking", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_web_v2_fetch_entertainment_ranking", "method": "GET", "path": "/apis/v1/tikhub/weibo/web_v2/fetch_entertainment_ranking" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:18a5c7d7555709349662f1b842327f98d0c12f47ce23077d312aab866822caf3" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-web_v2-fetch_entertainment_ranking" } }, "/apis/v1/tikhub/weibo/web_v2/fetch_hot_ranking_timeline": { "get": { "description": "Weibo (web_v2).\n\n### Purpose:\n- Get various types of hot ranking content from Weibo platform.\n### Parameters:\n- ranking_type: Ranking type (required)\n - hour: Hourly ranking\n - yesterday: Yesterday ranking\n - day_before: Day before ranking\n - week: Weekly ranking\n - male: Male ranking\n - female: Female ranking\n- max_id: Pagination cursor, pass \"0\" for first request\n- count: Count (default 10)\n### Return:\n- Hot post list, including post content, author info, interaction data\n### Note:\n- Different rankings have different update frequencies: hourly has highest real-time relevance, weekly has high influence\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_web_v2_fetch_hot_ranking_timeline", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Hot post list, including post content, author info, interaction data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_hot_ranking_timeline", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "abcabf80bb4c" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/web_v2/fetch_hot_ranking_timeline", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_web_v2_fetch_hot_ranking_timeline", "method": "GET", "path": "/apis/v1/tikhub/weibo/web_v2/fetch_hot_ranking_timeline" }, "parameters": [ { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Count, default is 10", "default": 10, "title": "Count" }, "description": "Count, default is 10", "example": 10 }, { "name": "max_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Max ID, default is 0", "default": "0", "title": "Max Id" }, "description": "Max ID, default is 0", "example": "0" }, { "name": "ranking_type", "in": "query", "required": true, "schema": { "type": "string", "description": "Ranking type (required)\n - hour: Hourly ranking\n - yesterday: Yesterday ranking\n - day_before: Day before ranking\n - week: Weekly ranking\n - male: Male ranking\n - female: Female ranking", "title": "Ranking Type" }, "description": "Ranking type (required)\n - hour: Hourly ranking\n - yesterday: Yesterday ranking\n - day_before: Day before ranking\n - week: Weekly ranking\n - male: Male ranking\n - female: Female ranking", "example": "hour" }, { "name": "since_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination identifier, default is 0", "default": "0", "title": "Since Id" }, "description": "Pagination identifier, default is 0", "example": "0" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:4fea3bfcea210cd04ed3ba967531273d3e5563087ca73bc1ff98fdba11463900" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/weibo/web_v2/fetch_hot_ranking_timeline?count=10&max_id=0&ranking_type=hour&since_id=0' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-web_v2-fetch_hot_ranking_timeline" } }, "/apis/v1/tikhub/weibo/web_v2/fetch_hot_search": { "get": { "description": "Weibo (web_v2).\n\n### Purpose:\n- Get Weibo real-time hot search ranking data.\n### Parameters:\n- No additional parameters required\n### Return:\n- Hot search data, including realtime (real-time hot search), hotgov and other sections\n### Note:\n- Hot search updates frequently, recommend caching for 2-5 minutes\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_web_v2_fetch_hot_search", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Hot search data, including realtime (real-time hot search), hotgov and other sections", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_hot_search", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web_v2", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "e01b20589929" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/web_v2/fetch_hot_search", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_web_v2_fetch_hot_search", "method": "GET", "path": "/apis/v1/tikhub/weibo/web_v2/fetch_hot_search" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:f60703768ef720c85915fec995be541ec43710c6a590242cdc40c3f876e076d4" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-web_v2-fetch_hot_search" } }, "/apis/v1/tikhub/weibo/web_v2/fetch_hot_search_index": { "get": { "description": "Weibo (web_v2).\n\n### Purpose:\n- Quickly get top 10 Weibo hot search items.\n### Parameters:\n- No additional parameters required\n### Return:\n- Hot search term list, including keyword, popularity value, rank\n### Note:\n- Only returns top 10 hot search items\n- Hot search updates frequently, recommend caching for 2-5 minutes\n- For complete hot search, use fetch_hot_search_summary\n\nAPI references: `fetch_hot_search_summary` = `GET /tikhub/weibo/web_v2/fetch_hot_search_summary` (operationId: `get_tikhub_weibo_web_v2_fetch_hot_search_summary`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_web_v2_fetch_hot_search_index", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Hot search term list, including keyword, popularity value, rank", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_hot_search_index", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "b53ba06cb010" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/web_v2/fetch_hot_search_index", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_web_v2_fetch_hot_search_index", "method": "GET", "path": "/apis/v1/tikhub/weibo/web_v2/fetch_hot_search_index" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:9f3f4670317241f0862da73a312ef5b0ee669206f3e07ed1c487e883a3347115" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-web_v2-fetch_hot_search_index" } }, "/apis/v1/tikhub/weibo/web_v2/fetch_hot_search_summary": { "get": { "description": "Weibo (web_v2).\n\n### Purpose:\n- Get complete Weibo hot search ranking (50 items).\n### Parameters:\n- No additional parameters required\n### Return:\n- Complete hot search list, including rank, keyword, tag (Hot/Boiling/Official/New), heat value\n### Note:\n- Difference from fetch_hot_search_index: this API returns 50 items, fetch_hot_search_index returns 10 items\n- rank 0 indicates pinned content\n- Recommend caching for 5-10 minutes\n\nAPI references: `fetch_hot_search_index` = `GET /tikhub/weibo/web_v2/fetch_hot_search_index` (operationId: `get_tikhub_weibo_web_v2_fetch_hot_search_index`).\n\n\nPublished reference price: $0.0015 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_web_v2_fetch_hot_search_summary", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Complete hot search list, including rank, keyword, tag (Hot/Boiling/Official/New), heat value", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_hot_search_summary", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.0015, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "0684fad7e914" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/web_v2/fetch_hot_search_summary", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_web_v2_fetch_hot_search_summary", "method": "GET", "path": "/apis/v1/tikhub/weibo/web_v2/fetch_hot_search_summary" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:218b3af64232425009faee1dc5da25dcfba8d33c753befe6a08b94693a5310af" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-web_v2-fetch_hot_search_summary" } }, "/apis/v1/tikhub/weibo/web_v2/fetch_life_ranking": { "get": { "description": "Weibo (web_v2).\n\n### Purpose:\n- Get Weibo life ranking data (food, travel, health, fashion).\n### Parameters:\n- No additional parameters required\n### Return:\n- Life topic list, including topic, heat value, rank, category\n### Note:\n- Recommend caching for 5-10 minutes\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_web_v2_fetch_life_ranking", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Life topic list, including topic, heat value, rank, category", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_life_ranking", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "2fd616657cee" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/web_v2/fetch_life_ranking", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_web_v2_fetch_life_ranking", "method": "GET", "path": "/apis/v1/tikhub/weibo/web_v2/fetch_life_ranking" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:ec9d56655d08fe805b37780591519772b96c2aa3578c047b1a539f9019458c7f" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-web_v2-fetch_life_ranking" } }, "/apis/v1/tikhub/weibo/web_v2/fetch_pic_search": { "get": { "description": "Weibo (web_v2).\n\n### Purpose:\n- Search Weibo picture content, aggregated by weibo ID.\n### Parameters:\n- query: Search keyword (required)\n- page: Page number (default 1)\n### Return:\n- Image list with weibo ID, thumbnail, large image URL, author info, image count\n### Note:\n- Thumbnails are automatically converted to large image URLs\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_web_v2_fetch_pic_search", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Image list with weibo ID, thumbnail, large image URL, author info, image count", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_pic_search", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "20ce04e5c0df" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/web_v2/fetch_pic_search", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_web_v2_fetch_pic_search", "method": "GET", "path": "/apis/v1/tikhub/weibo/web_v2/fetch_pic_search" }, "parameters": [ { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page number (default 1)", "default": 1, "title": "Page" }, "description": "Page number (default 1)", "example": 1 }, { "name": "query", "in": "query", "required": true, "schema": { "type": "string", "description": "Search keyword", "title": "Query" }, "description": "Search keyword", "example": "yu7" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:7cc23b72cf8f0d3325b66fc715fece5313e888e144989e6571ea0cb1b1f28a8f" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/weibo/web_v2/fetch_pic_search?page=1&query=yu7' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-web_v2-fetch_pic_search" } }, "/apis/v1/tikhub/weibo/web_v2/fetch_post_comments": { "get": { "description": "Weibo (web_v2).\n\n### Purpose:\n- Get the first-level comment list of specified post.\n### Parameters:\n- id: Weibo post ID (required)\n- count: Number of comments (default 10)\n- max_id: Pagination cursor, pass empty for first request, use returned max_id for subsequent requests\n### Return:\n- Comment list data, including comment content, commenter info, likes count\n- Contains max_id field for pagination\n### Note:\n- When no more comments, max_id is empty\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_web_v2_fetch_post_comments", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Comment list data, including comment content, commenter info, likes count\n- Contains max_id field for pagination", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_post_comments", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "0690b4918399" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/web_v2/fetch_post_comments", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_web_v2_fetch_post_comments", "method": "GET", "path": "/apis/v1/tikhub/weibo/web_v2/fetch_post_comments" }, "parameters": [ { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number of comments (default 10)", "default": 10, "title": "Count" }, "description": "Number of comments (default 10)", "example": 10 }, { "name": "id", "in": "query", "required": true, "schema": { "type": "string", "description": "Weibo ID", "title": "Id" }, "description": "Weibo ID", "example": "5283919831764022" }, { "name": "max_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Page number\n\nUsage: Pagination cursor, pass empty for first request, use returned max_id for subsequent requests", "default": "", "title": "Max Id" }, "description": "Page number\n\nUsage: Pagination cursor, pass empty for first request, use returned max_id for subsequent requests", "example": "" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:5e81f8d912828b003dbda87d6b63def629fce4828794cc976cf815cc9cc7cec0" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/weibo/web_v2/fetch_post_comments?count=10&id=5283919831764022&max_id=' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-web_v2-fetch_post_comments" } }, "/apis/v1/tikhub/weibo/web_v2/fetch_post_detail": { "get": { "description": "Weibo (web_v2).\n\n### Purpose:\n- Get detailed information of a specific Weibo post, including content, author, interaction data.\n### Parameters:\n- id: Weibo post ID (required)\n- is_get_long_text: Whether to get full text of long posts (default \"true\")\n### Return:\n- Post detailed data, including full text, images, videos, likes, comments, reposts count\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_web_v2_fetch_post_detail", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Post detailed data, including full text, images, videos, likes, comments, reposts count", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_post_detail", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "ff11fc16f331" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/web_v2/fetch_post_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_web_v2_fetch_post_detail", "method": "GET", "path": "/apis/v1/tikhub/weibo/web_v2/fetch_post_detail" }, "parameters": [ { "name": "id", "in": "query", "required": true, "schema": { "type": "string", "description": "Post ID", "title": "Id" }, "description": "Post ID", "example": "5092682368025584" }, { "name": "is_get_long_text", "in": "query", "required": false, "schema": { "type": "string", "description": "Whether to get the full text of long Weibo posts (true/false)\n\nUsage: Whether to get full text of long posts (default \"true\")", "default": "true", "title": "Is Get Long Text" }, "description": "Whether to get the full text of long Weibo posts (true/false)\n\nUsage: Whether to get full text of long posts (default \"true\")", "example": "true" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:9b9b2dc1813daebb12fd7b159d6591fba24b8281089339e99d8152627084dcb7" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/weibo/web_v2/fetch_post_detail?id=5092682368025584&is_get_long_text=true' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-web_v2-fetch_post_detail" } }, "/apis/v1/tikhub/weibo/web_v2/fetch_post_sub_comments": { "get": { "description": "Weibo (web_v2).\n\n### Purpose:\n- Get the reply (sub-comment) list of a specified comment.\n### Parameters:\n- id: Main comment ID (required)\n- count: Number of sub-comments (default 10)\n- max_id: Pagination cursor, pass empty for first request, use returned max_id for subsequent requests\n### Return:\n- Sub-comment list data, including reply content, replier info, likes count\n- Contains max_id field for pagination\n### Note:\n- Difference from fetch_post_comments: this API gets replies to comments, not main comments of posts\n\nAPI references: `fetch_post_comments` = `GET /tikhub/weibo/web_v2/fetch_post_comments` (operationId: `get_tikhub_weibo_web_v2_fetch_post_comments`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_web_v2_fetch_post_sub_comments", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Sub-comment list data, including reply content, replier info, likes count\n- Contains max_id field for pagination", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_post_sub_comments", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "c5c14b2b5f53" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/web_v2/fetch_post_sub_comments", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_web_v2_fetch_post_sub_comments", "method": "GET", "path": "/apis/v1/tikhub/weibo/web_v2/fetch_post_sub_comments" }, "parameters": [ { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number of sub-comments (default 10)", "default": 10, "title": "Count" }, "description": "Number of sub-comments (default 10)", "example": 10 }, { "name": "id", "in": "query", "required": true, "schema": { "type": "string", "description": "Comment ID", "title": "Id" }, "description": "Comment ID", "example": "5283574244704555" }, { "name": "max_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Page identifier\n\nUsage: Pagination cursor, pass empty for first request, use returned max_id for subsequent requests", "default": "", "title": "Max Id" }, "description": "Page identifier\n\nUsage: Pagination cursor, pass empty for first request, use returned max_id for subsequent requests", "example": "" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:7ec7ba68fb47f54312b6af1c670afa976880dab874c3de46bc7f36423fb3f83b" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/weibo/web_v2/fetch_post_sub_comments?count=10&id=5283574244704555&max_id=' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-web_v2-fetch_post_sub_comments" } }, "/apis/v1/tikhub/weibo/web_v2/fetch_realtime_search": { "get": { "description": "Weibo (web_v2).\n\n### Purpose:\n- Get Weibo realtime search results (latest posts sorted by time).\n### Parameters:\n- query: Search keyword (required)\n- page: Page number (default 1)\n### Return:\n- Realtime search result list, including post content, author info, images, videos, interaction data\n### Note:\n- Video playback requires setting header Referer=https://weibo.com/\n- Return structure is same as advanced search\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_web_v2_fetch_realtime_search", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Realtime search result list, including post content, author info, images, videos, interaction data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_realtime_search", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "7df4fadd899b" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/web_v2/fetch_realtime_search", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_web_v2_fetch_realtime_search", "method": "GET", "path": "/apis/v1/tikhub/weibo/web_v2/fetch_realtime_search" }, "parameters": [ { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page number (default 1)", "default": 1, "title": "Page" }, "description": "Page number (default 1)", "example": 1 }, { "name": "query", "in": "query", "required": true, "schema": { "type": "string", "description": "Search keyword", "title": "Query" }, "description": "Search keyword", "example": "yu7" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:ebcdecbba82664f149ec93c7fc4c6ec654f23214bb85100ab4120ee03aebbd8e" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/weibo/web_v2/fetch_realtime_search?page=1&query=yu7' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-web_v2-fetch_realtime_search" } }, "/apis/v1/tikhub/weibo/web_v2/fetch_similar_search": { "get": { "description": "Weibo (web_v2).\n\n### Purpose:\n- Get similar search word recommendations based on keyword.\n### Parameters:\n- keyword: Search keyword (required, supports topic tag format like #TopicName#)\n### Return:\n- Similar search term list, including suggestion, search count\n### Note:\n- Similar word recommendations are relatively stable, can cache for 15-30 minutes\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_web_v2_fetch_similar_search", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Similar search term list, including suggestion, search count", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_similar_search", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "be41a6598ac3" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/web_v2/fetch_similar_search", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_web_v2_fetch_similar_search", "method": "GET", "path": "/apis/v1/tikhub/weibo/web_v2/fetch_similar_search" }, "parameters": [ { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Search keyword (required, supports topic tag format like #TopicName#)", "title": "Keyword" }, "description": "Search keyword (required, supports topic tag format like #TopicName#)", "example": "#WeiboAdventures#" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:adaabfb5caa71615b9f052f66171603188a8e72750e52f603f380baf60bfef22" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/weibo/web_v2/fetch_similar_search?keyword=%23WeiboAdventures%23' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-web_v2-fetch_similar_search" } }, "/apis/v1/tikhub/weibo/web_v2/fetch_social_ranking": { "get": { "description": "Weibo (web_v2).\n\n### Purpose:\n- Get Weibo social ranking data (current affairs, social hotspots, livelihood topics).\n### Parameters:\n- No additional parameters required\n### Return:\n- Social topic list, including topic, heat value, rank, category\n### Note:\n- Social hotspots change rapidly, recommend caching for 2-5 minutes\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_web_v2_fetch_social_ranking", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Social topic list, including topic, heat value, rank, category", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_social_ranking", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "615553c05400" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/web_v2/fetch_social_ranking", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_web_v2_fetch_social_ranking", "method": "GET", "path": "/apis/v1/tikhub/weibo/web_v2/fetch_social_ranking" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:d8a3e5f253c937f2a347fe4866f642f6904fc79b18598f412887783200bc8458" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-web_v2-fetch_social_ranking" } }, "/apis/v1/tikhub/weibo/web_v2/fetch_topic_search": { "get": { "description": "Weibo (web_v2).\n\n### Purpose\n- Search Weibo topics, get topic name, cover, discussion count, read count.\n\n### Parameters\n- query: Search keyword (required)\n- page: Page number (default 1)\n\n### Return\n- Topic list with topic name, cover image, discussion count, read count\n\n### Note\n- Counts expressed in ten-thousand or hundred-million units are converted to integers\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_web_v2_fetch_topic_search", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Topic list with topic name, cover image, discussion count, read count", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_topic_search", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "bc942e4a52c9" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/web_v2/fetch_topic_search", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_web_v2_fetch_topic_search", "method": "GET", "path": "/apis/v1/tikhub/weibo/web_v2/fetch_topic_search" }, "parameters": [ { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page number (default 1)", "default": 1, "title": "Page" }, "description": "Page number (default 1)", "example": 1 }, { "name": "query", "in": "query", "required": true, "schema": { "type": "string", "description": "Search keyword", "title": "Query" }, "description": "Search keyword", "example": "yu7" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:d8f4c25eed2808d09781dd058ab7b2184a8f1de1d68e461ec11f8e8c4db7e3cd" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/weibo/web_v2/fetch_topic_search?page=1&query=yu7' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-web_v2-fetch_topic_search" } }, "/apis/v1/tikhub/weibo/web_v2/fetch_user_basic_info": { "get": { "description": "Weibo (web_v2).\n\n### Purpose:\n- Get basic information of Weibo users (lightweight API).\n### Parameters:\n- uid: User ID (required)\n### Return:\n- User basic info, including user ID, username, avatar, bio, verification\n### Note:\n- Compared to fetch_user_info, this API returns less data with faster response\n- Suitable for batch user info retrieval and user card display\n\nAPI references: `fetch_user_info` = `GET /tikhub/weibo/web_v2/fetch_user_info` (operationId: `get_tikhub_weibo_web_v2_fetch_user_info`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_web_v2_fetch_user_basic_info", "responses": { "200": { "description": "Successful Response\n\n### Return\n- User basic info, including user ID, username, avatar, bio, verification", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_user_basic_info", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "40d6d0488335" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/web_v2/fetch_user_basic_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_web_v2_fetch_user_basic_info", "method": "GET", "path": "/apis/v1/tikhub/weibo/web_v2/fetch_user_basic_info" }, "parameters": [ { "name": "uid", "in": "query", "required": true, "schema": { "type": "string", "description": "User id", "title": "Uid" }, "description": "User id", "example": "7277477906" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:6ec3f071297d262ed89abece71e898b0d0d3b7e62d171697339ee2b00b1fd907" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/weibo/web_v2/fetch_user_basic_info?uid=7277477906' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-web_v2-fetch_user_basic_info" } }, "/apis/v1/tikhub/weibo/web_v2/fetch_user_fans": { "get": { "description": "Weibo (web_v2).\n\n### Purpose:\n- Get the fans list of specified user (who follows the user).\n### Parameters:\n- uid: User ID (required)\n- page: Page number, starts from 0 (default 0)\n### Return:\n- Fans user list, including username, avatar, bio, followers count\n### Note:\n- Fans list affected by user privacy settings\n- page parameter starts from 0, not 1\n- Difference from fetch_user_following: this API gets who follows the user, fetch_user_following gets who user follows\n\nAPI references: `fetch_user_following` = `GET /tikhub/weibo/web_v2/fetch_user_following` (operationId: `get_tikhub_weibo_web_v2_fetch_user_following`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_web_v2_fetch_user_fans", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Fans user list, including username, avatar, bio, followers count", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_user_fans", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "8850744c1b1a" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/web_v2/fetch_user_fans", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_web_v2_fetch_user_fans", "method": "GET", "path": "/apis/v1/tikhub/weibo/web_v2/fetch_user_fans" }, "parameters": [ { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page number, starts from 0 (default 0)", "default": 0, "title": "Page" }, "description": "Page number, starts from 0 (default 0)", "example": 0 }, { "name": "uid", "in": "query", "required": true, "schema": { "type": "string", "description": "User ID", "title": "Uid" }, "description": "User ID", "example": "1722594714" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:d09fe35d1b9cffbc58c70b956388f8aca16d9b94d422879993bfab678e15f4d0" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/weibo/web_v2/fetch_user_fans?page=0&uid=1722594714' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-web_v2-fetch_user_fans" } }, "/apis/v1/tikhub/weibo/web_v2/fetch_user_following": { "get": { "description": "Weibo (web_v2).\n\n### Purpose:\n- Get the following list of specified user (who the user follows).\n### Parameters:\n- uid: User ID (required)\n- page: Page number, starts from 0 (default 0)\n### Return:\n- Following user list, including username, avatar, bio, followers count\n### Note:\n- Following list affected by user privacy settings\n- page parameter starts from 0, not 1\n- Difference from fetch_user_fans: this API gets who user follows, fetch_user_fans gets who follows the user\n\nAPI references: `fetch_user_fans` = `GET /tikhub/weibo/web_v2/fetch_user_fans` (operationId: `get_tikhub_weibo_web_v2_fetch_user_fans`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_web_v2_fetch_user_following", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Following user list, including username, avatar, bio, followers count", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_user_following", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web_v2", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "1a77e3463b56" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/web_v2/fetch_user_following", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_web_v2_fetch_user_following", "method": "GET", "path": "/apis/v1/tikhub/weibo/web_v2/fetch_user_following" }, "parameters": [ { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page number, starts from 0 (default 0)", "default": 0, "title": "Page" }, "description": "Page number, starts from 0 (default 0)", "example": 0 }, { "name": "uid", "in": "query", "required": true, "schema": { "type": "string", "description": "User ID", "title": "Uid" }, "description": "User ID", "example": "1722594714" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:aa201047e7f22043ab3868c124f909c3db90da06206e7b4d70f4ca0012ce33be" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/weibo/web_v2/fetch_user_following?page=0&uid=1722594714' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-web_v2-fetch_user_following" } }, "/apis/v1/tikhub/weibo/web_v2/fetch_user_info": { "get": { "description": "Weibo (web_v2).\n\n### Purpose:\n- Get detailed information of Weibo users, including nickname, avatar, bio, following count, followers count.\n### Parameters:\n- uid: User ID (optional, choose one with custom)\n- custom: Custom username (optional, choose one with uid)\n### Return:\n- User detailed information data\n### Note:\n- At least one of uid and custom must be provided\n- If both provided, uid takes priority\n- It's recommended to use uid parameter first\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_web_v2_fetch_user_info", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- User detailed information data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_user_info", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web_v2", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "297d79b3ce84" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/web_v2/fetch_user_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_web_v2_fetch_user_info", "method": "GET", "path": "/apis/v1/tikhub/weibo/web_v2/fetch_user_info" }, "parameters": [ { "name": "custom", "in": "query", "required": false, "schema": { "description": "Custom Weibo username", "default": "", "title": "Custom", "type": [ "string", "null" ] }, "description": "Custom Weibo username", "example": "shuqi" }, { "name": "uid", "in": "query", "required": false, "schema": { "description": "User ID (optional, choose one with custom)", "default": "", "title": "Uid", "type": [ "string", "null" ] }, "description": "User ID (optional, choose one with custom)", "example": "1722594714" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:29d4034cca88362d11e957d230c6d6b3ae8c56e9300f8ef3ee0b77d7879ca9b5" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-web_v2-fetch_user_info" } }, "/apis/v1/tikhub/weibo/web_v2/fetch_user_original_posts": { "get": { "description": "Weibo (web_v2).\n\n### Purpose:\n- Get original posts published by specified user (excluding reposts).\n### Parameters:\n- uid: User ID (required)\n- page: Page number, starts from 1 (default 1)\n- since_id: Pagination identifier (first page must get from fetch_user_posts)\n### Return:\n- Original post list, including content, images, videos, interaction data\n### Note:\n- Difference from fetch_user_posts: this API only returns original posts, excludes reposts\n- since_id must be obtained from fetch_user_posts first, required for first page, not needed for subsequent pages\n\nAPI references: `fetch_user_posts` = `GET /tikhub/weibo/web_v2/fetch_user_posts` (operationId: `get_tikhub_weibo_web_v2_fetch_user_posts`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_web_v2_fetch_user_original_posts", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Original post list, including content, images, videos, interaction data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_user_original_posts", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "2d5dd125a279" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/web_v2/fetch_user_original_posts", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_web_v2_fetch_user_original_posts", "method": "GET", "path": "/apis/v1/tikhub/weibo/web_v2/fetch_user_original_posts" }, "parameters": [ { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page number, starts from 1 (default 1)", "default": 1, "title": "Page" }, "description": "Page number, starts from 1 (default 1)", "example": 1 }, { "name": "since_id", "in": "query", "required": false, "schema": { "type": "string", "description": "For the first page, obtain the `since_id` field from the response of `GET /tikhub/weibo/web_v2/fetch_user_posts` (operationId: `get_tikhub_weibo_web_v2_fetch_user_posts`) and pass it here. The official documentation requires this value for the first page and says it is not needed for subsequent pages. The query parameter remains optional because this requirement is conditional on the first page.", "default": "", "title": "Since Id" }, "description": "For the first page, obtain the `since_id` field from the response of `GET /tikhub/weibo/web_v2/fetch_user_posts` (operationId: `get_tikhub_weibo_web_v2_fetch_user_posts`) and pass it here. The official documentation requires this value for the first page and says it is not needed for subsequent pages. The query parameter remains optional because this requirement is conditional on the first page.", "example": "" }, { "name": "uid", "in": "query", "required": true, "schema": { "type": "string", "description": "User id", "title": "Uid" }, "description": "User id", "example": "7277477906" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:1ec68bf14c07e80415c11f72ec95f2c32da0636df5e343c13edd41ee019e0498" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/weibo/web_v2/fetch_user_original_posts?page=1&since_id=&uid=7277477906' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-web_v2-fetch_user_original_posts" } }, "/apis/v1/tikhub/weibo/web_v2/fetch_user_posts": { "get": { "description": "Weibo (web_v2).\n\n### Purpose\nGet a user's published posts with pagination and selectable response detail.\n\n### Parameters\n- uid: Required user ID.\n- page: Page number starting at 1; defaults to 1.\n- feature: Response detail level, default 0. Value 0 returns 10 basic posts; 1, 2, and 3 return 20 posts with progressively richer fields. Use 3 for the highest detail level.\n- since_id: Pass the returned since_id to retrieve the next page.\n\n### Return\nPost content, images, videos, and a since_id for pagination. Feature 0 has the best performance.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_web_v2_fetch_user_posts", "responses": { "200": { "description": "Successful Response\n\n### Return\nPost content, images, videos, and a since_id for pagination. Feature 0 has the best performance.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_user_posts", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "ec4a7acc58e9" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/web_v2/fetch_user_posts", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_web_v2_fetch_user_posts", "method": "GET", "path": "/apis/v1/tikhub/weibo/web_v2/fetch_user_posts" }, "parameters": [ { "name": "feature", "in": "query", "required": false, "schema": { "type": "integer", "description": "Response detail level: 0 returns 10 basic posts; 1, 2, and 3 return 20 posts with progressively richer fields. Use 3 for the highest detail level.", "default": 0, "title": "Feature" }, "description": "Response detail level: 0 returns 10 basic posts; 1, 2, and 3 return 20 posts with progressively richer fields. Use 3 for the highest detail level.", "example": 0 }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page number, starts from 1 (default 1)", "default": 1, "title": "Page" }, "description": "Page number, starts from 1 (default 1)", "example": 1 }, { "name": "since_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination identifier for getting next page data", "default": "", "title": "Since Id" }, "description": "Pagination identifier for getting next page data", "example": "" }, { "name": "uid", "in": "query", "required": true, "schema": { "type": "string", "description": "User id", "title": "Uid" }, "description": "User id", "example": "7277477906" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:6ea651d6143273c5aff7ddabeea94c8e03c1f5f565bbe8bcb12b3349deaaae50" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/weibo/web_v2/fetch_user_posts?feature=0&page=1&since_id=&uid=7277477906' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-web_v2-fetch_user_posts" } }, "/apis/v1/tikhub/weibo/web_v2/fetch_user_recommend_timeline": { "get": { "description": "Weibo (web_v2).\n\n### Purpose:\n- Get recommended timeline content from Weibo homepage, displaying personalized recommendations based on user interests.\n### Parameters:\n- refresh: Refresh type (0=normal refresh, 1=force refresh)\n- group_id: Group ID (can be obtained through fetch_all_groups)\n- containerid: Container ID (usually same as group_id)\n- extparam: Extended parameters (default \"discover|new_feed\")\n- max_id: Pagination cursor, pass \"0\" for first request\n- count: Count (default 10, suggested 5-20)\n### Return:\n- Recommended post list, including post content, author info, interaction data\n- Contains max_id field for pagination\n### Note:\n- Recommend calling fetch_all_groups first to get available groups\n\nAPI references: `fetch_all_groups` = `GET /tikhub/weibo/web_v2/fetch_all_groups` (operationId: `get_tikhub_weibo_web_v2_fetch_all_groups`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_web_v2_fetch_user_recommend_timeline", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Recommended post list, including post content, author info, interaction data\n- Contains max_id field for pagination", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_user_recommend_timeline", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "113e36512e41" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/web_v2/fetch_user_recommend_timeline", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_web_v2_fetch_user_recommend_timeline", "method": "GET", "path": "/apis/v1/tikhub/weibo/web_v2/fetch_user_recommend_timeline" }, "parameters": [ { "name": "containerid", "in": "query", "required": false, "schema": { "type": "string", "description": "Container ID (usually same as group_id)", "default": "102803", "title": "Containerid" }, "description": "Container ID (usually same as group_id)", "example": "102803" }, { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Count (default 10, suggested 5-20)", "default": 10, "title": "Count" }, "description": "Count (default 10, suggested 5-20)", "example": 10 }, { "name": "extparam", "in": "query", "required": false, "schema": { "type": "string", "description": "Extended parameters (default \"discover|new_feed\")", "default": "discover|new_feed", "title": "Extparam" }, "description": "Extended parameters (default \"discover|new_feed\")", "example": "discover|new_feed" }, { "name": "group_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Group ID (can be obtained through fetch_all_groups)\n\nAPI references: `fetch_all_groups` = `GET /tikhub/weibo/web_v2/fetch_all_groups` (operationId: `get_tikhub_weibo_web_v2_fetch_all_groups`).", "default": "102803", "title": "Group Id" }, "description": "Group ID (can be obtained through fetch_all_groups)\n\nAPI references: `fetch_all_groups` = `GET /tikhub/weibo/web_v2/fetch_all_groups` (operationId: `get_tikhub_weibo_web_v2_fetch_all_groups`).", "example": "102803" }, { "name": "max_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Max ID\n\nUsage: Pagination cursor, pass \"0\" for first request", "default": "0", "title": "Max Id" }, "description": "Max ID\n\nUsage: Pagination cursor, pass \"0\" for first request", "example": "0" }, { "name": "refresh", "in": "query", "required": false, "schema": { "type": "integer", "description": "Refresh type: 0=normal refresh, 1=force refresh", "default": 0, "title": "Refresh" }, "description": "Refresh type: 0=normal refresh, 1=force refresh", "example": 0 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:227fc9b3a896926cb174b2c70bb5d38017c33aed765adc23c20a2b84c40275cb" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-web_v2-fetch_user_recommend_timeline" } }, "/apis/v1/tikhub/weibo/web_v2/fetch_user_search": { "get": { "description": "Weibo (web_v2).\n\n### Purpose\n- Search Weibo users with multiple filter options.\n\n### Parameters\n- query: Search keyword (optional)\n- page: Page number (default 1)\n- region: Region code from /tikhub/weibo/web_v2/fetch_city_list (optional)\n- auth: Auth type org_vip/per_vip/ord (optional)\n- gender: Gender man/women (optional)\n- age: Age bucket 18y/22y/29y/39y/40y (optional)\n- nickname: Nickname filter (optional)\n- tag: Tag filter (optional)\n- school: School filter (optional)\n- work: Company filter (optional)\n\n### Return\n- User list with uid, nickname, avatar, fans count, profile URL\n\n### Note\n- Too many filters may result in no results\n\nAPI references: `fetch_city_list` = `GET /tikhub/weibo/web_v2/fetch_city_list` (operationId: `get_tikhub_weibo_web_v2_fetch_city_list`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_web_v2_fetch_user_search", "responses": { "200": { "description": "Successful Response\n\n### Return\n- User list with uid, nickname, avatar, fans count, profile URL", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_user_search", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "bd7db426ffb8" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/web_v2/fetch_user_search", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_web_v2_fetch_user_search", "method": "GET", "path": "/apis/v1/tikhub/weibo/web_v2/fetch_user_search" }, "parameters": [ { "name": "age", "in": "query", "required": false, "schema": { "description": "Age bucket: 18y/22y/29y/39y/40y", "title": "Age", "type": [ "string", "null" ] }, "description": "Age bucket: 18y/22y/29y/39y/40y", "example": "22y" }, { "name": "auth", "in": "query", "required": false, "schema": { "description": "Auth type: org_vip (organization), per_vip (individual), ord (standard)\n\nUsage: Auth type org_vip/per_vip/ord (optional)", "title": "Auth", "type": [ "string", "null" ] }, "description": "Auth type: org_vip (organization), per_vip (individual), ord (standard)\n\nUsage: Auth type org_vip/per_vip/ord (optional)", "example": "org_vip" }, { "name": "gender", "in": "query", "required": false, "schema": { "description": "Gender: man / women", "title": "Gender", "type": [ "string", "null" ] }, "description": "Gender: man / women", "example": "man" }, { "name": "nickname", "in": "query", "required": false, "schema": { "description": "Nickname filter", "title": "Nickname", "type": [ "string", "null" ] }, "description": "Nickname filter", "example": "Zhang San" }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page number (default 1)", "default": 1, "title": "Page" }, "description": "Page number (default 1)", "example": 1 }, { "name": "query", "in": "query", "required": false, "schema": { "description": "Search keyword/Query (if provided, treated as 'all' search; leave empty to apply only advanced filter parameters)", "title": "Query", "type": [ "string", "null" ] }, "description": "Search keyword/Query (if provided, treated as 'all' search; leave empty to apply only advanced filter parameters)", "example": "yu7" }, { "name": "region", "in": "query", "required": false, "schema": { "description": "Region code from /tikhub/weibo/web_v2/fetch_city_list (optional)\n\nAPI references: `fetch_city_list` = `GET /tikhub/weibo/web_v2/fetch_city_list` (operationId: `get_tikhub_weibo_web_v2_fetch_city_list`).", "title": "Region", "type": [ "string", "null" ] }, "description": "Region code from /tikhub/weibo/web_v2/fetch_city_list (optional)\n\nAPI references: `fetch_city_list` = `GET /tikhub/weibo/web_v2/fetch_city_list` (operationId: `get_tikhub_weibo_web_v2_fetch_city_list`).", "example": "custom:11:1" }, { "name": "school", "in": "query", "required": false, "schema": { "description": "School filter", "title": "School", "type": [ "string", "null" ] }, "description": "School filter", "example": "Tsinghua University" }, { "name": "tag", "in": "query", "required": false, "schema": { "description": "Tag filter", "title": "Tag", "type": [ "string", "null" ] }, "description": "Tag filter", "example": "摄影" }, { "name": "work", "in": "query", "required": false, "schema": { "description": "Company filter", "title": "Work", "type": [ "string", "null" ] }, "description": "Company filter", "example": "ByteDance" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:7b731723913225fe58fee3e63fe392aa1f4a78a5afc9f7818c2947b4f761a3f9" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-web_v2-fetch_user_search" } }, "/apis/v1/tikhub/weibo/web_v2/fetch_user_video_collection_detail": { "get": { "description": "Weibo (web_v2).\n\n### Purpose:\n- Get detailed content of specified collection, including video list.\n### Parameters:\n- cid: Collection ID (required, get from fetch_user_video_collection_list)\n- cursor: Pagination cursor, pass empty for first request, use returned cursor for subsequent\n- tab_code: Sort type (0=default, 1=hottest, 2=latest)\n### Return:\n- Collection info and video list, including video title, cover, duration, views\n- Contains next_cursor and has_more fields for pagination\n### Note:\n- Cursors for different sorting methods are not universal, switching sorting requires restarting pagination\n\nAPI references: `fetch_user_video_collection_list` = `GET /tikhub/weibo/web_v2/fetch_user_video_collection_list` (operationId: `get_tikhub_weibo_web_v2_fetch_user_video_collection_list`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_web_v2_fetch_user_video_collection_detail", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Collection info and video list, including video title, cover, duration, views\n- Contains next_cursor and has_more fields for pagination", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_user_video_collection_detail", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "ba0555837c40" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/web_v2/fetch_user_video_collection_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_web_v2_fetch_user_video_collection_detail", "method": "GET", "path": "/apis/v1/tikhub/weibo/web_v2/fetch_user_video_collection_detail" }, "parameters": [ { "name": "cid", "in": "query", "required": true, "schema": { "type": "string", "description": "Collection ID (required, get from fetch_user_video_collection_list)\n\nAPI references: `fetch_user_video_collection_list` = `GET /tikhub/weibo/web_v2/fetch_user_video_collection_list` (operationId: `get_tikhub_weibo_web_v2_fetch_user_video_collection_list`).", "title": "Cid" }, "description": "Collection ID (required, get from fetch_user_video_collection_list)\n\nAPI references: `fetch_user_video_collection_list` = `GET /tikhub/weibo/web_v2/fetch_user_video_collection_list` (operationId: `get_tikhub_weibo_web_v2_fetch_user_video_collection_list`).", "example": "4883992307236954" }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination cursor, pass empty for first request, use returned cursor for subsequent", "default": "", "title": "Cursor" }, "description": "Pagination cursor, pass empty for first request, use returned cursor for subsequent", "example": "" }, { "name": "tab_code", "in": "query", "required": false, "schema": { "type": "integer", "description": "Sort type: 0=default, 1=hottest, 2=latest", "default": 0, "title": "Tab Code" }, "description": "Sort type: 0=default, 1=hottest, 2=latest", "example": 0 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:159bb66032410dbafacfd38c68f42ebe1544c9db43a520ba3ef168255475c6c0" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/weibo/web_v2/fetch_user_video_collection_detail?cid=4883992307236954&cursor=&tab_code=0' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-web_v2-fetch_user_video_collection_detail" } }, "/apis/v1/tikhub/weibo/web_v2/fetch_user_video_collection_list": { "get": { "description": "Weibo (web_v2).\n\n### Purpose:\n- Get video collection list of specified user.\n### Parameters:\n- uid: User ID (required)\n### Return:\n- Collection list, including collection ID, name, description, video count\n### Note:\n- Collection list affected by user privacy settings\n- Some users may not have created video collections\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_web_v2_fetch_user_video_collection_list", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Collection list, including collection ID, name, description, video count", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_user_video_collection_list", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "8973b1dd5c35" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/web_v2/fetch_user_video_collection_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_web_v2_fetch_user_video_collection_list", "method": "GET", "path": "/apis/v1/tikhub/weibo/web_v2/fetch_user_video_collection_list" }, "parameters": [ { "name": "uid", "in": "query", "required": true, "schema": { "type": "string", "description": "User ID", "title": "Uid" }, "description": "User ID", "example": "7277477906" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:197a0b5f3dda62fabb913dc62c00b40a329f4a747d43814a1966202f48481fcc" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/weibo/web_v2/fetch_user_video_collection_list?uid=7277477906' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-web_v2-fetch_user_video_collection_list" } }, "/apis/v1/tikhub/weibo/web_v2/fetch_user_video_list": { "get": { "description": "Weibo (web_v2).\n\n### Purpose:\n- Get all videos published by specified user (waterfall layout).\n### Parameters:\n- uid: User ID (required)\n- cursor: Pagination cursor, pass \"0\" for first request, use returned next_cursor for subsequent requests\n### Return:\n- Video list data, including video title, cover, views, etc.\n- Contains next_cursor and has_more fields for pagination\n### Note:\n- Difference from collection APIs: this API gets user published videos, collection APIs get user collected videos\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_web_v2_fetch_user_video_list", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Video list data, including video title, cover, views, etc.\n- Contains next_cursor and has_more fields for pagination", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_user_video_list", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "9d01aa38296c" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/web_v2/fetch_user_video_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_web_v2_fetch_user_video_list", "method": "GET", "path": "/apis/v1/tikhub/weibo/web_v2/fetch_user_video_list" }, "parameters": [ { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination cursor, pass \"0\" for first request, use returned next_cursor for subsequent requests", "default": "0", "title": "Cursor" }, "description": "Pagination cursor, pass \"0\" for first request, use returned next_cursor for subsequent requests", "example": "0" }, { "name": "uid", "in": "query", "required": true, "schema": { "type": "string", "description": "User ID", "title": "Uid" }, "description": "User ID", "example": "7277477906" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:14674d7e95ea2aa8f0d2421740c0f93f3cf630238af222471134b569e84a9a01" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/weibo/web_v2/fetch_user_video_list?cursor=0&uid=7277477906' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-web_v2-fetch_user_video_list" } }, "/apis/v1/tikhub/weibo/web_v2/fetch_video_search": { "get": { "description": "Weibo (web_v2).\n\n### Purpose:\n- Search Weibo video content, supports hot and all modes.\n### Parameters:\n- query: Search keyword (required)\n- mode: Search mode hot=popular / all=all (default hot)\n- page: Page number (default 1)\n### Return:\n- Video list with weibo ID, author, content, video URL, interaction data\n### Note:\n- Video playback requires setting Referer=https://weibo.com/\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_web_v2_fetch_video_search", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Video list with weibo ID, author, content, video URL, interaction data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo fetch_video_search", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "6dc3f37af823" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/web_v2/fetch_video_search", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_web_v2_fetch_video_search", "method": "GET", "path": "/apis/v1/tikhub/weibo/web_v2/fetch_video_search" }, "parameters": [ { "name": "mode", "in": "query", "required": false, "schema": { "type": "string", "description": "Search mode: hot=trending, all=all\n\nUsage: Search mode hot=popular / all=all (default hot)", "default": "hot", "title": "Mode" }, "description": "Search mode: hot=trending, all=all\n\nUsage: Search mode hot=popular / all=all (default hot)", "example": "hot" }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page number (default 1)", "default": 1, "title": "Page" }, "description": "Page number (default 1)", "example": 1 }, { "name": "query", "in": "query", "required": true, "schema": { "type": "string", "description": "Search keyword", "title": "Query" }, "description": "Search keyword", "example": "yu7" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e29f1b73a326308834681ec822db3c4da6d50a219dc28011e32f22420fc97863" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/weibo/web_v2/fetch_video_search?mode=hot&page=1&query=yu7' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-web_v2-fetch_video_search" } }, "/apis/v1/tikhub/weibo/web_v2/search_user_posts": { "get": { "description": "Weibo (web_v2).\n\n### Purpose:\n- Search for content containing specific keywords in a specified user's posts.\n### Parameters:\n- uid: User ID (required)\n- q: Search keyword (optional, empty string means search all content)\n- page: Page number, starts from 1 (default 1)\n- starttime: Start timestamp (optional, Unix timestamp format)\n- endtime: End timestamp (optional, Unix timestamp format)\n- hasori: Include original posts (default 1 include)\n- hasret: Include retweets (default 1 include)\n- hastext: Include text posts (default 1 include)\n- haspic: Include image posts (default 1 include)\n- hasvideo: Include video posts (default 1 include)\n- hasmusic: Include music posts (default 1 include)\n### Return:\n- Search result list, including post content, author info, interaction data\n### Note:\n- Search results affected by user privacy settings\n- Timestamp parameters use Unix timestamp format\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_weibo_web_v2_search_user_posts", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Search result list, including post content, author info, interaction data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "weibo search_user_posts", "tags": [ "tikhub.weibo" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "2d2627539e36" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/weibo/web_v2/search_user_posts", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_weibo_web_v2_search_user_posts", "method": "GET", "path": "/apis/v1/tikhub/weibo/web_v2/search_user_posts" }, "parameters": [ { "name": "endtime", "in": "query", "required": false, "schema": { "description": "End timestamp (optional, Unix timestamp format)", "default": 1772294400, "title": "Endtime", "type": [ "integer", "null" ] }, "description": "End timestamp (optional, Unix timestamp format)", "example": 1772294400 }, { "name": "hasmusic", "in": "query", "required": false, "schema": { "type": "integer", "description": "Include music posts: 1=include, 0=exclude", "default": 1, "title": "Hasmusic" }, "description": "Include music posts: 1=include, 0=exclude", "example": 1 }, { "name": "hasori", "in": "query", "required": false, "schema": { "type": "integer", "description": "Include original posts: 1=include, 0=exclude", "default": 1, "title": "Hasori" }, "description": "Include original posts: 1=include, 0=exclude", "example": 1 }, { "name": "haspic", "in": "query", "required": false, "schema": { "type": "integer", "description": "Include image posts: 1=include, 0=exclude", "default": 1, "title": "Haspic" }, "description": "Include image posts: 1=include, 0=exclude", "example": 1 }, { "name": "hasret", "in": "query", "required": false, "schema": { "type": "integer", "description": "Include retweets: 1=include, 0=exclude", "default": 1, "title": "Hasret" }, "description": "Include retweets: 1=include, 0=exclude", "example": 1 }, { "name": "hastext", "in": "query", "required": false, "schema": { "type": "integer", "description": "Include text posts: 1=include, 0=exclude", "default": 1, "title": "Hastext" }, "description": "Include text posts: 1=include, 0=exclude", "example": 1 }, { "name": "hasvideo", "in": "query", "required": false, "schema": { "type": "integer", "description": "Include video posts: 1=include, 0=exclude", "default": 1, "title": "Hasvideo" }, "description": "Include video posts: 1=include, 0=exclude", "example": 1 }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page number, starts from 1 (default 1)", "default": 1, "title": "Page" }, "description": "Page number, starts from 1 (default 1)", "example": 1 }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string", "description": "Search keyword (optional, empty string means search all content)", "default": "", "title": "Q" }, "description": "Search keyword (optional, empty string means search all content)" }, { "name": "starttime", "in": "query", "required": false, "schema": { "description": "Start timestamp (optional, Unix timestamp format)", "default": 1772294400, "title": "Starttime", "type": [ "integer", "null" ] }, "description": "Start timestamp (optional, Unix timestamp format)", "example": 1772294400 }, { "name": "uid", "in": "query", "required": true, "schema": { "type": "string", "description": "User ID", "title": "Uid" }, "description": "User ID", "example": "7277477906" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:c7f6e6ee50538217edb4d38c087cb68326f93aaa34ff3033a84e6f6beebc39bd" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/weibo/web_v2/search_user_posts?endtime=1772294400&hasmusic=1&hasori=1&haspic=1&hasret=1&hastext=1&hasvideo=1&page=1&starttime=1772294400&uid=7277477906' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-weibo-web_v2-search_user_posts" } }, "/apis/v1/tikhub/xiaohongshu/app_v2/get_creator_hot_inspiration_feed": { "get": { "description": "Xiaohongshu (app_v2).\n\n### Purpose:\n- Get creator center hot inspiration feed, using cursor pagination\n### Parameters:\n- cursor: Pagination cursor, leave empty for first request, pass cursor value from previous response (e.g. \"1\", \"2\"...)\n### Return:\n- Hot inspiration feed data\n### Pagination Guide:\n- First request: leave cursor empty\n- Next page: pass cursor value from previous response\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_xiaohongshu_app_v2_get_creator_hot_inspiration_feed", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Hot inspiration feed data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "xiaohongshu get_creator_hot_inspiration_feed", "tags": [ "tikhub.xiaohongshu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "00f7860e360b" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/xiaohongshu/app_v2/get_creator_hot_inspiration_feed", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_xiaohongshu_app_v2_get_creator_hot_inspiration_feed", "method": "GET", "path": "/apis/v1/tikhub/xiaohongshu/app_v2/get_creator_hot_inspiration_feed" }, "parameters": [ { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination cursor, leave empty for first request, pass cursor value from previous response (e.g. \"1\", \"2\"...)", "default": "", "title": "Cursor" }, "description": "Pagination cursor, leave empty for first request, pass cursor value from previous response (e.g. \"1\", \"2\"...)", "example": "" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:8a28abef322e0749a6b8fb66817eaaad40e676a9203bde22a58ee5c8ef34eac4" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-xiaohongshu-app_v2-get_creator_hot_inspiration_feed" } }, "/apis/v1/tikhub/xiaohongshu/app_v2/get_creator_inspiration_feed": { "get": { "description": "Xiaohongshu (app_v2).\n\n### Purpose:\n- Get creator center recommended inspiration feed, using cursor pagination\n### Parameters:\n- cursor: Pagination cursor, leave empty for first request, pass cursor value from previous response (e.g. \"r_1\", \"r_2\"...)\n- tab: Tab type, default 0\n- source: Source, default \"creator_center\"\n### Return:\n- Recommended inspiration feed data\n### Pagination Guide:\n- First request: leave cursor empty\n- Next page: pass cursor value from previous response\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_xiaohongshu_app_v2_get_creator_inspiration_feed", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Recommended inspiration feed data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "xiaohongshu get_creator_inspiration_feed", "tags": [ "tikhub.xiaohongshu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "347a030529f5" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/xiaohongshu/app_v2/get_creator_inspiration_feed", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_xiaohongshu_app_v2_get_creator_inspiration_feed", "method": "GET", "path": "/apis/v1/tikhub/xiaohongshu/app_v2/get_creator_inspiration_feed" }, "parameters": [ { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination cursor, leave empty for first request, pass cursor value from previous response (e.g. \"r_1\", \"r_2\"...)", "default": "", "title": "Cursor" }, "description": "Pagination cursor, leave empty for first request, pass cursor value from previous response (e.g. \"r_1\", \"r_2\"...)", "example": "" }, { "name": "source", "in": "query", "required": false, "schema": { "type": "string", "description": "Source, default \"creator_center\"", "default": "creator_center", "title": "Source" }, "description": "Source, default \"creator_center\"", "example": "creator_center" }, { "name": "tab", "in": "query", "required": false, "schema": { "type": "integer", "description": "Tab type, default 0", "default": 0, "title": "Tab" }, "description": "Tab type, default 0", "example": 0 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:0c5d22525d2f34808f67b998b75456f59c67e10fb27f90a4966f28ca107b3a9a" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-xiaohongshu-app_v2-get_creator_inspiration_feed" } }, "/apis/v1/tikhub/xiaohongshu/app_v2/get_image_note_detail": { "get": { "description": "Xiaohongshu (app_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get full detail data of an image note\n\n### API Priority\n- ⭐ Xiaohongshu API priority: `App V2 (this)` > `App` > `Web V2` > `Web`\n\n### ⚠️ Note Type Notice (Important)\n- Xiaohongshu notes come in two types: `image notes (normal)` and `video notes (video)`. Make sure to distinguish them when using the APIs.\n- This endpoint can fetch data for **both image notes and video notes**.\n- However, due to Xiaohongshu's official restriction: when the requested note is a video note, this endpoint **will NOT return the video play URL, only the video cover image**.\n- To get the video play URL, use `/tikhub/xiaohongshu/app_v2/get_video_note_detail` (video note endpoint), which can only fetch data of video notes.\n\n### Recommended Workflow (when note type is unknown)\n- 1. Request this endpoint (image note endpoint) first.\n- 2. Check the note type field in the response (e.g. whether `type` is `video`) to determine if it is a video note.\n- 3. If it is a video note and you need the video play URL, request `/tikhub/xiaohongshu/app_v2/get_video_note_detail` again with the same note_id to get the video play URL.\n\n### ⚠️ Billing Notice\n- If a wrong or non-existent note ID is passed (or the share link fails to parse), the endpoint still responds normally, but the `data` field will contain an upstream \"service error\" message. Such requests **will still be billed as normal**. Please make sure the parameters are valid before calling.\n\n### Parameters\n- note_id: Note ID, e.g. \"697c0eee000000000a03c308\"\n- share_text: Xiaohongshu sharing link, supports APP and Web sharing links, including `xiaohongshu.com` full links, `xhslink.com` and `xhslink.cn` short links\n- Prefer to use `note_id`, if not, use `share_text`, one of the two parameters is required, if both are carried, `note_id` shall prevail.\n\n### Return\n- Image note detail data, including note content, image list, author info, interaction data, etc.\n- For video notes, only basic data such as the cover image is returned, without the video play URL\n\nAPI references: `get_video_note_detail` = `GET /tikhub/xiaohongshu/app_v2/get_video_note_detail` (operationId: `get_tikhub_xiaohongshu_app_v2_get_video_note_detail`).\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_xiaohongshu_app_v2_get_image_note_detail", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Image note detail data, including note content, image list, author info, interaction data, etc.\n- For video notes, only basic data such as the cover image is returned, without the video play URL", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "xiaohongshu get_image_note_detail", "tags": [ "tikhub.xiaohongshu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "46a3f57a6d60" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/xiaohongshu/app_v2/get_image_note_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_xiaohongshu_app_v2_get_image_note_detail", "method": "GET", "path": "/apis/v1/tikhub/xiaohongshu/app_v2/get_image_note_detail" }, "parameters": [ { "name": "note_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Note ID, e.g. \"697c0eee000000000a03c308\"", "default": "", "title": "Note Id" }, "description": "Note ID, e.g. \"697c0eee000000000a03c308\"", "example": "697c0eee000000000a03c308" }, { "name": "share_text", "in": "query", "required": false, "schema": { "type": "string", "description": "Share link, supports xiaohongshu.com, xhslink.com, xhslink.cn\n\nUsage: Xiaohongshu sharing link, supports APP and Web sharing links, including `xiaohongshu.com` full links, `xhslink.com` and `xhslink.cn` short links", "default": "", "title": "Share Text" }, "description": "Share link, supports xiaohongshu.com, xhslink.com, xhslink.cn\n\nUsage: Xiaohongshu sharing link, supports APP and Web sharing links, including `xiaohongshu.com` full links, `xhslink.com` and `xhslink.cn` short links", "example": "http://xhslink.com/o/8GqargIxrko" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:ae68127de567d9cb8d61b26713578782183d9be571286677a5b3b29a68b105d7" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-xiaohongshu-app_v2-get_image_note_detail" } }, "/apis/v1/tikhub/xiaohongshu/app_v2/get_note_comments": { "get": { "description": "Xiaohongshu (app_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get comment list for a specified note, supports pagination and multiple sort strategies\n\n### ⚠️ Billing Notice\n- If a wrong or non-existent note ID is passed (or the share link fails to parse), the endpoint still responds normally, but the `data` field will contain an upstream \"service error\" message. Such requests **will still be billed as normal**. Please make sure the parameters are valid before calling.\n\n### Parameters\n- note_id: Note ID, e.g. \"697c0eee000000000a03c308\"\n- share_text: Xiaohongshu sharing link, supports APP and Web sharing links, including `xiaohongshu.com` full links, `xhslink.com` and `xhslink.cn` short links\n- Prefer to use `note_id`, if not, use `share_text`, one of the two parameters is required, if both are carried, `note_id` shall prevail.\n- cursor: Pagination cursor, leave empty for first request, pass cursor value from previous response for next page\n- index: Comment index, pass 0 for first request, pass index value from previous response for next page\n- pageArea: Fold status, default \"UNFOLDED\" (unfolded), pass pageArea value from previous response for next page\n- sort_strategy: Sort strategy\n - \"latest_v2\": Sort by time desc (latest, recommended default)\n - \"like_count\": Sort by like_count\n - \"default\": Sort by default (not recommended, may cause missing or duplicate comments when paginating)\n\n### Return\n- Comments data object, including comment list, pagination cursor, etc.\n\n### Pagination Guide\n- First request: leave cursor empty, pass index as 0\n- Next page: pass cursor and index and pageArea values from previous response\n- The pagination fields are usually located in the `$.data.data` object of the response (e.g. cursor ← `$.data.data.cursor`), extract the corresponding values from the previous response\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_xiaohongshu_app_v2_get_note_comments", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Comments data object, including comment list, pagination cursor, etc.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "xiaohongshu get_note_comments", "tags": [ "tikhub.xiaohongshu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "121dd8890edd" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/xiaohongshu/app_v2/get_note_comments", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_xiaohongshu_app_v2_get_note_comments", "method": "GET", "path": "/apis/v1/tikhub/xiaohongshu/app_v2/get_note_comments" }, "parameters": [ { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination cursor, leave empty for first request, pass cursor value from previous response for next page", "default": "", "title": "Cursor" }, "description": "Pagination cursor, leave empty for first request, pass cursor value from previous response for next page", "example": "" }, { "name": "index", "in": "query", "required": false, "schema": { "type": "integer", "description": "Comment index, pass 0 for first request, pass index value from previous response for next page", "default": 0, "title": "Index" }, "description": "Comment index, pass 0 for first request, pass index value from previous response for next page", "example": 0 }, { "name": "note_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Note ID, e.g. \"697c0eee000000000a03c308\"", "default": "", "title": "Note Id" }, "description": "Note ID, e.g. \"697c0eee000000000a03c308\"", "example": "697c0eee000000000a03c308" }, { "name": "pageArea", "in": "query", "required": false, "schema": { "type": "string", "description": "Fold state: UNFOLDED (default, expanded), FOLDED (collapsed)\n\nUsage: Fold status, default \"UNFOLDED\" (unfolded), pass pageArea value from previous response for next page", "default": "UNFOLDED", "title": "Pagearea" }, "description": "Fold state: UNFOLDED (default, expanded), FOLDED (collapsed)\n\nUsage: Fold status, default \"UNFOLDED\" (unfolded), pass pageArea value from previous response for next page", "example": "UNFOLDED" }, { "name": "share_text", "in": "query", "required": false, "schema": { "type": "string", "description": "Share link, supports xiaohongshu.com, xhslink.com, xhslink.cn\n\nUsage: Xiaohongshu sharing link, supports APP and Web sharing links, including `xiaohongshu.com` full links, `xhslink.com` and `xhslink.cn` short links", "default": "", "title": "Share Text" }, "description": "Share link, supports xiaohongshu.com, xhslink.com, xhslink.cn\n\nUsage: Xiaohongshu sharing link, supports APP and Web sharing links, including `xiaohongshu.com` full links, `xhslink.com` and `xhslink.cn` short links", "example": "http://xhslink.com/o/8GqargIxrko" }, { "name": "sort_strategy", "in": "query", "required": false, "schema": { "type": "string", "description": "Sort strategy\n - \"latest_v2\": Sort by time desc (latest, recommended default)\n - \"like_count\": Sort by like_count\n - \"default\": Sort by default (not recommended, may cause missing or duplicate comments when paginating)", "default": "latest_v2", "title": "Sort Strategy" }, "description": "Sort strategy\n - \"latest_v2\": Sort by time desc (latest, recommended default)\n - \"like_count\": Sort by like_count\n - \"default\": Sort by default (not recommended, may cause missing or duplicate comments when paginating)", "example": "latest_v2" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:df434708347351fd27418131f4318302dcbbe8c66d6af883172c0befa4932057" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-xiaohongshu-app_v2-get_note_comments" } }, "/apis/v1/tikhub/xiaohongshu/app_v2/get_note_sub_comments": { "get": { "description": "Xiaohongshu (app_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get sub-comment (reply) list under a specific comment of a note, using cursor pagination\n\n### ⚠️ Billing Notice\n- If a wrong or non-existent note ID / comment ID is passed (or the share link fails to parse), the endpoint still responds normally, but the `data` field will contain an upstream \"service error\" message. Such requests **will still be billed as normal**. Please make sure the parameters are valid before calling.\n\n### Parameters\n- note_id: Note ID, e.g. \"699916e6000000001d0253da\"\n- share_text: Xiaohongshu sharing link, supports APP and Web sharing links, including `xiaohongshu.com` full links, `xhslink.com` and `xhslink.cn` short links\n- Prefer to use `note_id`, if not, use `share_text`, one of the two parameters is required, if both are carried, `note_id` shall prevail.\n- comment_id: Parent comment ID (required), e.g. \"699fb9930000000008030db6\"\n- cursor: Pagination cursor, leave empty for first request, extract `cursor` value from `$.data.data.cursor` of previous response for next page\n- index: Pagination index, pass 1 for first request, extract `index` value from `$.data.data.cursor` of previous response for next page\n\n### Return\n- Sub-comments data object, including sub-comment list, pagination cursor, etc.\n\n### Pagination Guide\n- The `$.data.data.cursor` in response is a JSON object, e.g. `{\"cursor\":\"69a0c134000000000c00910d\",\"index\":3}`\n- First request: leave cursor empty, pass index as 1\n- Next page: extract `cursor` and `index` from `$.data.data.cursor` and pass them as corresponding parameters\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_xiaohongshu_app_v2_get_note_sub_comments", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Sub-comments data object, including sub-comment list, pagination cursor, etc.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "xiaohongshu get_note_sub_comments", "tags": [ "tikhub.xiaohongshu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "bcffcfad49fc" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/xiaohongshu/app_v2/get_note_sub_comments", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_xiaohongshu_app_v2_get_note_sub_comments", "method": "GET", "path": "/apis/v1/tikhub/xiaohongshu/app_v2/get_note_sub_comments" }, "parameters": [ { "name": "comment_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Parent comment ID (required), e.g. \"699fb9930000000008030db6\"", "title": "Comment Id" }, "description": "Parent comment ID (required), e.g. \"699fb9930000000008030db6\"", "example": "699fb9930000000008030db6" }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination cursor, leave empty for first request, extract `cursor` value from `$.data.data.cursor` of previous response for next page", "default": "", "title": "Cursor" }, "description": "Pagination cursor, leave empty for first request, extract `cursor` value from `$.data.data.cursor` of previous response for next page", "example": "" }, { "name": "index", "in": "query", "required": false, "schema": { "type": "integer", "description": "Pagination index, pass 1 for first request, extract `index` value from `$.data.data.cursor` of previous response for next page", "default": 1, "title": "Index" }, "description": "Pagination index, pass 1 for first request, extract `index` value from `$.data.data.cursor` of previous response for next page", "example": 1 }, { "name": "note_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Note ID, e.g. \"699916e6000000001d0253da\"", "default": "", "title": "Note Id" }, "description": "Note ID, e.g. \"699916e6000000001d0253da\"", "example": "699916e6000000001d0253da" }, { "name": "share_text", "in": "query", "required": false, "schema": { "type": "string", "description": "Share link, supports xiaohongshu.com, xhslink.com, xhslink.cn\n\nUsage: Xiaohongshu sharing link, supports APP and Web sharing links, including `xiaohongshu.com` full links, `xhslink.com` and `xhslink.cn` short links", "default": "", "title": "Share Text" }, "description": "Share link, supports xiaohongshu.com, xhslink.com, xhslink.cn\n\nUsage: Xiaohongshu sharing link, supports APP and Web sharing links, including `xiaohongshu.com` full links, `xhslink.com` and `xhslink.cn` short links", "example": "http://xhslink.com/o/8GqargIxrko" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:0e2a9e6571589eda7b56d18d49369d499b860de58107d5499b9c24de68c61843" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/xiaohongshu/app_v2/get_note_sub_comments?comment_id=699fb9930000000008030db6&cursor=&index=1¬e_id=699916e6000000001d0253da&share_text=http%3A%2F%2Fxhslink.com%2Fo%2F8GqargIxrko' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-xiaohongshu-app_v2-get_note_sub_comments" } }, "/apis/v1/tikhub/xiaohongshu/app_v2/get_product_detail": { "get": { "description": "Xiaohongshu (app_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get product detail by SKU ID, including price, specifications, stock, description, etc.\n\n### ⚠️ Billing Notice\n- If a wrong or non-existent product SKU ID is passed, the endpoint still responds normally, but the `data` field will contain an upstream \"service error\" message. Such requests **will still be billed as normal**. Please make sure the parameters are valid before calling.\n\n### Parameters\n- sku_id: Product SKU ID (required), e.g. \"669ddd44e05f3700011067ed\"\n- source: Source, default \"mall_search\"\n- pre_page: Previous page, default \"mall_search\"\n\n### Return\n- Product detail data, including price, specifications, stock, description, etc.\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_xiaohongshu_app_v2_get_product_detail", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Product detail data, including price, specifications, stock, description, etc.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "xiaohongshu get_product_detail", "tags": [ "tikhub.xiaohongshu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "565fac36a16d" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/xiaohongshu/app_v2/get_product_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_xiaohongshu_app_v2_get_product_detail", "method": "GET", "path": "/apis/v1/tikhub/xiaohongshu/app_v2/get_product_detail" }, "parameters": [ { "name": "pre_page", "in": "query", "required": false, "schema": { "type": "string", "description": "Previous page, default \"mall_search\"", "default": "mall_search", "title": "Pre Page" }, "description": "Previous page, default \"mall_search\"", "example": "mall_search" }, { "name": "sku_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Product SKU ID (required), e.g. \"669ddd44e05f3700011067ed\"", "title": "Sku Id" }, "description": "Product SKU ID (required), e.g. \"669ddd44e05f3700011067ed\"", "example": "669ddd44e05f3700011067ed" }, { "name": "source", "in": "query", "required": false, "schema": { "type": "string", "description": "Source, default \"mall_search\"", "default": "mall_search", "title": "Source" }, "description": "Source, default \"mall_search\"", "example": "mall_search" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:678cfe07c57b51036305e9442ec931ca8b20cf96de421c1671251ea1b1eee464" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/xiaohongshu/app_v2/get_product_detail?pre_page=mall_search&sku_id=669ddd44e05f3700011067ed&source=mall_search' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-xiaohongshu-app_v2-get_product_detail" } }, "/apis/v1/tikhub/xiaohongshu/app_v2/get_product_recommendations": { "get": { "description": "Xiaohongshu (app_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get recommended products list by SKU ID, using cursor pagination\n\n### ⚠️ Billing Notice\n- If a wrong or non-existent product SKU ID is passed, the endpoint still responds normally, but the `data` field will contain an upstream \"service error\" message. Such requests **will still be billed as normal**. Please make sure the parameters are valid before calling.\n\n### Parameters\n- sku_id: Product SKU ID (required), e.g. \"669ddd44e05f3700011067ed\"\n- cursor_score: Pagination cursor, leave empty for first request, pass cursor_score value from previous response for next page\n- region: Region, default \"US\"\n\n### Return\n- Recommended products list data\n\n### Pagination Guide\n- First request: leave cursor_score empty\n- Next page: pass cursor_score value from previous response\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_xiaohongshu_app_v2_get_product_recommendations", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Recommended products list data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "xiaohongshu get_product_recommendations", "tags": [ "tikhub.xiaohongshu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "5a66fb48d727" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/xiaohongshu/app_v2/get_product_recommendations", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_xiaohongshu_app_v2_get_product_recommendations", "method": "GET", "path": "/apis/v1/tikhub/xiaohongshu/app_v2/get_product_recommendations" }, "parameters": [ { "name": "cursor_score", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination cursor, leave empty for first request, pass cursor_score value from previous response for next page", "default": "", "title": "Cursor Score" }, "description": "Pagination cursor, leave empty for first request, pass cursor_score value from previous response for next page", "example": "" }, { "name": "region", "in": "query", "required": false, "schema": { "type": "string", "description": "Region", "default": "US", "title": "Region" }, "description": "Region", "example": "US" }, { "name": "sku_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Product SKU ID (required), e.g. \"669ddd44e05f3700011067ed\"", "title": "Sku Id" }, "description": "Product SKU ID (required), e.g. \"669ddd44e05f3700011067ed\"", "example": "669ddd44e05f3700011067ed" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:6773e00e44b261269298044bf03c85cdc035622156eb7c1d911575c1e1c38ac8" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/xiaohongshu/app_v2/get_product_recommendations?cursor_score=®ion=US&sku_id=669ddd44e05f3700011067ed' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-xiaohongshu-app_v2-get_product_recommendations" } }, "/apis/v1/tikhub/xiaohongshu/app_v2/get_product_review_overview": { "get": { "description": "Xiaohongshu (app_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get product review statistics, including rating distribution, positive rate, review tags, etc.\n\n### ⚠️ Billing Notice\n- If a wrong or non-existent product SKU ID is passed, the endpoint still responds normally, but the `data` field will contain an upstream \"service error\" message. Such requests **will still be billed as normal**. Please make sure the parameters are valid before calling.\n\n### Parameters\n- sku_id: Product SKU ID (required), e.g. \"669ddd44e05f3700011067ed\"\n- tab: Tab type, default 2\n\n### Return\n- Product review overview data, including rating distribution, positive rate, review tags, etc.\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_xiaohongshu_app_v2_get_product_review_overview", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Product review overview data, including rating distribution, positive rate, review tags, etc.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "xiaohongshu get_product_review_overview", "tags": [ "tikhub.xiaohongshu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "c833763d7642" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/xiaohongshu/app_v2/get_product_review_overview", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_xiaohongshu_app_v2_get_product_review_overview", "method": "GET", "path": "/apis/v1/tikhub/xiaohongshu/app_v2/get_product_review_overview" }, "parameters": [ { "name": "sku_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Product SKU ID (required), e.g. \"669ddd44e05f3700011067ed\"", "title": "Sku Id" }, "description": "Product SKU ID (required), e.g. \"669ddd44e05f3700011067ed\"", "example": "669ddd44e05f3700011067ed" }, { "name": "tab", "in": "query", "required": false, "schema": { "type": "integer", "description": "Tab type, default 2", "default": 2, "title": "Tab" }, "description": "Tab type, default 2", "example": 2 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:34fb74a8b162dfde891ed6c53a7d9f2bedad7059a039bad2ce2b61fb69b18020" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/xiaohongshu/app_v2/get_product_review_overview?sku_id=669ddd44e05f3700011067ed&tab=2' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-xiaohongshu-app_v2-get_product_review_overview" } }, "/apis/v1/tikhub/xiaohongshu/app_v2/get_product_reviews": { "get": { "description": "Xiaohongshu (app_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get product user reviews list, supports pagination, sorting, and filtering reviews with images\n\n### ⚠️ Billing Notice\n- If a wrong or non-existent product SKU ID is passed, the endpoint still responds normally, but the `data` field will contain an upstream \"service error\" message. Such requests **will still be billed as normal**. Please make sure the parameters are valid before calling.\n\n### Parameters\n- sku_id: Product SKU ID (required), e.g. \"669ddd44e05f3700011067ed\"\n- page: Page number, start from 0\n- sort_strategy_type: Sort strategy\n - 0: General sort (default)\n - 1: Latest sort\n- share_pics_only: Show reviews with images only, 0=no, 1=yes\n- from_page: From page, default \"score_page\"\n\n### Return\n- Product reviews list data\n\n### Pagination Guide\n- page starts from 0 and increments\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_xiaohongshu_app_v2_get_product_reviews", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Product reviews list data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "xiaohongshu get_product_reviews", "tags": [ "tikhub.xiaohongshu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "47b1133caf28" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/xiaohongshu/app_v2/get_product_reviews", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_xiaohongshu_app_v2_get_product_reviews", "method": "GET", "path": "/apis/v1/tikhub/xiaohongshu/app_v2/get_product_reviews" }, "parameters": [ { "name": "from_page", "in": "query", "required": false, "schema": { "type": "string", "description": "From page, default \"score_page\"", "default": "score_page", "title": "From Page" }, "description": "From page, default \"score_page\"", "example": "score_page" }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page number, start from 0", "default": 0, "title": "Page" }, "description": "Page number, start from 0", "example": 0 }, { "name": "share_pics_only", "in": "query", "required": false, "schema": { "type": "integer", "description": "Show reviews with images only: 0=no, 1=yes", "default": 0, "title": "Share Pics Only" }, "description": "Show reviews with images only: 0=no, 1=yes", "example": 0 }, { "name": "sku_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Product SKU ID (required), e.g. \"669ddd44e05f3700011067ed\"", "title": "Sku Id" }, "description": "Product SKU ID (required), e.g. \"669ddd44e05f3700011067ed\"", "example": "669ddd44e05f3700011067ed" }, { "name": "sort_strategy_type", "in": "query", "required": false, "schema": { "type": "integer", "description": "Sort strategy: 0=general, 1=latest\n\nUsage: Sort strategy\n - 0: General sort (default)\n - 1: Latest sort", "default": 0, "title": "Sort Strategy Type" }, "description": "Sort strategy: 0=general, 1=latest\n\nUsage: Sort strategy\n - 0: General sort (default)\n - 1: Latest sort", "example": 0 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:c525781af72d208fac09688a1d2a03ce8ade264fc581aa935da626e3c09bebcc" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/xiaohongshu/app_v2/get_product_reviews?from_page=score_page&page=0&share_pics_only=0&sku_id=669ddd44e05f3700011067ed&sort_strategy_type=0' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-xiaohongshu-app_v2-get_product_reviews" } }, "/apis/v1/tikhub/xiaohongshu/app_v2/get_topic_feed": { "get": { "description": "Xiaohongshu (app_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get notes list under a specified topic, supports sorting by trending or latest, using cursor pagination\n\n### ⚠️ Billing Notice\n- If a wrong or non-existent topic page ID is passed, the endpoint still responds normally, but the `data` field will contain an upstream \"service error\" message. Such requests **will still be billed as normal**. Please make sure the parameters are valid before calling.\n\n### Parameters\n- page_id: Topic page ID (required), e.g. \"5c1cc866febed9000184b7c1\"\n - Can be obtained from single note API or search API\n- sort: Sort type\n - \"trend\": Trending (default)\n - \"time\": Latest\n- cursor_score: Pagination cursor score, pass last item's cursor_score from previous response\n- last_note_id: Last note ID from previous page\n- last_note_ct: Last note create time from previous page\n- session_id: Session ID, keep consistent for pagination\n- first_load_time: First load timestamp, keep consistent for pagination\n- source: Source, default \"normal\"\n\n### Return\n- Topic notes list data\n\n### Pagination Guide\n- First request: only pass page_id and sort, leave others empty\n- Next page: pass fields from last item of previous response:\n - cursor_score ← items[-1].cursor_score\n - last_note_id ← items[-1].id\n - last_note_ct ← items[-1].create_time\n- Recommended to also pass session_id and first_load_time for session consistency\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_xiaohongshu_app_v2_get_topic_feed", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Topic notes list data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "xiaohongshu get_topic_feed", "tags": [ "tikhub.xiaohongshu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "876a3ef45635" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/xiaohongshu/app_v2/get_topic_feed", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_xiaohongshu_app_v2_get_topic_feed", "method": "GET", "path": "/apis/v1/tikhub/xiaohongshu/app_v2/get_topic_feed" }, "parameters": [ { "name": "cursor_score", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination cursor score for next page\n\nUsage: Pagination cursor score, pass last item's cursor_score from previous response", "default": "", "title": "Cursor Score" }, "description": "Pagination cursor score for next page\n\nUsage: Pagination cursor score, pass last item's cursor_score from previous response", "example": "" }, { "name": "first_load_time", "in": "query", "required": false, "schema": { "type": "string", "description": "First load timestamp, keep consistent for pagination", "default": "", "title": "First Load Time" }, "description": "First load timestamp, keep consistent for pagination", "example": "" }, { "name": "last_note_ct", "in": "query", "required": false, "schema": { "type": "string", "description": "Last note creation time from the previous page (required for pagination)", "default": "", "title": "Last Note Ct" }, "description": "Last note creation time from the previous page (required for pagination)", "example": "" }, { "name": "last_note_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Last note ID from the previous page (required for pagination)", "default": "", "title": "Last Note Id" }, "description": "Last note ID from the previous page (required for pagination)", "example": "" }, { "name": "page_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Topic page ID (required), e.g. \"5c1cc866febed9000184b7c1\"\n - Can be obtained from single note API or search API", "title": "Page Id" }, "description": "Topic page ID (required), e.g. \"5c1cc866febed9000184b7c1\"\n - Can be obtained from single note API or search API", "example": "5c1cc866febed9000184b7c1" }, { "name": "session_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Session ID; keep consistent across pages for pagination", "default": "", "title": "Session Id" }, "description": "Session ID; keep consistent across pages for pagination", "example": "" }, { "name": "sort", "in": "query", "required": false, "schema": { "type": "string", "description": "Sort: trend=hottest, time=latest\n\nUsage: Sort type\n - \"trend\": Trending (default)\n - \"time\": Latest", "default": "trend", "title": "Sort" }, "description": "Sort: trend=hottest, time=latest\n\nUsage: Sort type\n - \"trend\": Trending (default)\n - \"time\": Latest", "example": "trend" }, { "name": "source", "in": "query", "required": false, "schema": { "type": "string", "description": "Source", "default": "normal", "title": "Source" }, "description": "Source", "example": "normal" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:d24d433f3ff56e6026d3b6411219c0661213546f5c32c720ba32e91a4889afab" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/xiaohongshu/app_v2/get_topic_feed?cursor_score=&first_load_time=&last_note_ct=&last_note_id=&page_id=5c1cc866febed9000184b7c1&session_id=&sort=trend&source=normal' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-xiaohongshu-app_v2-get_topic_feed" } }, "/apis/v1/tikhub/xiaohongshu/app_v2/get_topic_info": { "get": { "description": "Xiaohongshu (app_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get topic detail info, including topic name, view count, discussion count, share info, etc.\n\n### ⚠️ Billing Notice\n- If a wrong or non-existent topic page ID is passed, the endpoint still responds normally, but the `data` field will contain an upstream \"service error\" message. Such requests **will still be billed as normal**. Please make sure the parameters are valid before calling.\n\n### Parameters\n- page_id: Topic page ID (required), e.g. \"5c1cc866febed9000184b7c1\"\n- source: Source, default \"normal\"\n- note_id: Source note ID, pass when jumping from note to topic (optional)\n\n### Return\n- Topic detail data, including page_info (name/view count/discussion count), tabs, share_info, etc.\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_xiaohongshu_app_v2_get_topic_info", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Topic detail data, including page_info (name/view count/discussion count), tabs, share_info, etc.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "xiaohongshu get_topic_info", "tags": [ "tikhub.xiaohongshu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "0f96c2ef6ae5" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/xiaohongshu/app_v2/get_topic_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_xiaohongshu_app_v2_get_topic_info", "method": "GET", "path": "/apis/v1/tikhub/xiaohongshu/app_v2/get_topic_info" }, "parameters": [ { "name": "note_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Source note ID, pass when jumping from note to topic", "default": "", "title": "Note Id" }, "description": "Source note ID, pass when jumping from note to topic", "example": "" }, { "name": "page_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Topic page ID (required), e.g. \"5c1cc866febed9000184b7c1\"", "title": "Page Id" }, "description": "Topic page ID (required), e.g. \"5c1cc866febed9000184b7c1\"", "example": "5c1cc866febed9000184b7c1" }, { "name": "source", "in": "query", "required": false, "schema": { "type": "string", "description": "Source", "default": "normal", "title": "Source" }, "description": "Source", "example": "normal" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:36b25cecbcd45ba9dfe1429ba742a9c9c56af00a18a29098abba8b73d8fbfeb3" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/xiaohongshu/app_v2/get_topic_info?note_id=&page_id=5c1cc866febed9000184b7c1&source=normal' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-xiaohongshu-app_v2-get_topic_info" } }, "/apis/v1/tikhub/xiaohongshu/app_v2/get_user_faved_notes": { "get": { "description": "Xiaohongshu (app_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get list of notes faved by a specified user, using cursor pagination\n\n### ⚠️ Billing Notice\n- If a wrong or non-existent user ID is passed (or the share link fails to parse), the endpoint still responds normally, but the `data` field will contain an upstream \"service error\" message. Such requests **will still be billed as normal**. Please make sure the parameters are valid before calling.\n\n### Parameters\n- user_id: User ID, e.g. \"5a8cf39111be10466d285d6b\"\n- share_text: Xiaohongshu sharing link, supports APP and Web sharing links, including `xiaohongshu.com` full links, `xhslink.com` and `xhslink.cn` short links\n- Prefer to use `user_id`, if not, use `share_text`, one of the two parameters is required, if both are carried, `user_id` shall prevail.\n- cursor: Pagination cursor, leave empty for first request, pass last note_id from previous page for next page\n\n### Return\n- User faved notes list data, including basic note info and pagination info\n\n### Pagination Guide\n- First request: leave cursor empty\n- Next page: pass last note_id from previous page\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_xiaohongshu_app_v2_get_user_faved_notes", "responses": { "200": { "description": "Successful Response\n\n### Return\n- User faved notes list data, including basic note info and pagination info", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "xiaohongshu get_user_faved_notes", "tags": [ "tikhub.xiaohongshu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "73c4862ba855" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/xiaohongshu/app_v2/get_user_faved_notes", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_xiaohongshu_app_v2_get_user_faved_notes", "method": "GET", "path": "/apis/v1/tikhub/xiaohongshu/app_v2/get_user_faved_notes" }, "parameters": [ { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination cursor, leave empty for first request, pass last note_id from previous page for next page", "default": "", "title": "Cursor" }, "description": "Pagination cursor, leave empty for first request, pass last note_id from previous page for next page", "example": "" }, { "name": "share_text", "in": "query", "required": false, "schema": { "type": "string", "description": "Share link, supports xiaohongshu.com, xhslink.com, xhslink.cn\n\nUsage: Xiaohongshu sharing link, supports APP and Web sharing links, including `xiaohongshu.com` full links, `xhslink.com` and `xhslink.cn` short links", "default": "", "title": "Share Text" }, "description": "Share link, supports xiaohongshu.com, xhslink.com, xhslink.cn\n\nUsage: Xiaohongshu sharing link, supports APP and Web sharing links, including `xiaohongshu.com` full links, `xhslink.com` and `xhslink.cn` short links", "example": "https://xhslink.com/a/EZ4M9TwMA6c3" }, { "name": "user_id", "in": "query", "required": false, "schema": { "type": "string", "description": "User ID, e.g. \"5a8cf39111be10466d285d6b\"", "default": "", "title": "User Id" }, "description": "User ID, e.g. \"5a8cf39111be10466d285d6b\"", "example": "5a8cf39111be10466d285d6b" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:633d5e6d93deecc7a6ccb510d089608c168d4fc6d6e8a41108e75df1d57916c0" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-xiaohongshu-app_v2-get_user_faved_notes" } }, "/apis/v1/tikhub/xiaohongshu/app_v2/get_user_info": { "get": { "description": "Xiaohongshu (app_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get detailed info of a specified user\n\n### ⚠️ Notice (Important)\n- Make sure the `user_id` you pass is correct and valid. If a wrong or non-existent user ID is passed, the endpoint will still respond normally, but the `data` field will contain a \"service error\" message from Xiaohongshu official.\n- Since the request has actually been sent and returned successfully, such requests **will still be billed as normal**. Please validate the user ID before calling.\n\n### Parameters\n- user_id: User ID, e.g. \"61b46d790000000010008153\"\n- share_text: Xiaohongshu sharing link, supports APP and Web sharing links, including `xiaohongshu.com` full links, `xhslink.com` and `xhslink.cn` short links\n- Prefer to use `user_id`, if not, use `share_text`, one of the two parameters is required, if both are carried, `user_id` shall prevail.\n\n### Return\n- User detailed info, including nickname, avatar, bio, follower count, following count, note count, etc.\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_xiaohongshu_app_v2_get_user_info", "responses": { "200": { "description": "Successful Response\n\n### Return\n- User detailed info, including nickname, avatar, bio, follower count, following count, note count, etc.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "xiaohongshu get_user_info", "tags": [ "tikhub.xiaohongshu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "7d591c67424d" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/xiaohongshu/app_v2/get_user_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_xiaohongshu_app_v2_get_user_info", "method": "GET", "path": "/apis/v1/tikhub/xiaohongshu/app_v2/get_user_info" }, "parameters": [ { "name": "share_text", "in": "query", "required": false, "schema": { "type": "string", "description": "Share link, supports xiaohongshu.com, xhslink.com, xhslink.cn\n\nUsage: Xiaohongshu sharing link, supports APP and Web sharing links, including `xiaohongshu.com` full links, `xhslink.com` and `xhslink.cn` short links", "default": "", "title": "Share Text" }, "description": "Share link, supports xiaohongshu.com, xhslink.com, xhslink.cn\n\nUsage: Xiaohongshu sharing link, supports APP and Web sharing links, including `xiaohongshu.com` full links, `xhslink.com` and `xhslink.cn` short links", "example": "https://xhslink.com/m/3ZSCJZAMz0a" }, { "name": "user_id", "in": "query", "required": false, "schema": { "type": "string", "description": "User ID, e.g. \"61b46d790000000010008153\"", "default": "", "title": "User Id" }, "description": "User ID, e.g. \"61b46d790000000010008153\"", "example": "61b46d790000000010008153" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:51489920e538691e56da462157c6597e51ac21e6cfff17ec3c67ce16a9b041d2" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-xiaohongshu-app_v2-get_user_info" } }, "/apis/v1/tikhub/xiaohongshu/app_v2/get_user_posted_notes": { "get": { "description": "Xiaohongshu (app_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get list of notes posted by a specified user, using cursor pagination\n\n### ⚠️ Billing Notice\n- If a wrong or non-existent user ID is passed (or the share link fails to parse), the endpoint still responds normally, but the `data` field will contain an upstream \"service error\" message. Such requests **will still be billed as normal**. Please make sure the parameters are valid before calling.\n\n### Parameters\n- user_id: User ID, e.g. \"61b46d790000000010008153\"\n- share_text: Xiaohongshu sharing link, supports APP and Web sharing links, including `xiaohongshu.com` full links, `xhslink.com` and `xhslink.cn` short links\n- Prefer to use `user_id`, if not, use `share_text`, one of the two parameters is required, if both are carried, `user_id` shall prevail.\n- cursor: Pagination cursor, leave empty for first request, pass cursor value from previous response for next page\n - The cursor is usually the note_id of the last note in the notes list\n - JSON path example: `$.data.data.notes[-1].cursor`\n\n### Return\n- User posted notes list data, including basic note info and pagination info\n\n### Pagination Guide\n- First request: leave cursor empty\n- Next page: pass cursor value from previous response\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_xiaohongshu_app_v2_get_user_posted_notes", "responses": { "200": { "description": "Successful Response\n\n### Return\n- User posted notes list data, including basic note info and pagination info", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "xiaohongshu get_user_posted_notes", "tags": [ "tikhub.xiaohongshu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "9c0ee387e8be" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/xiaohongshu/app_v2/get_user_posted_notes", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_xiaohongshu_app_v2_get_user_posted_notes", "method": "GET", "path": "/apis/v1/tikhub/xiaohongshu/app_v2/get_user_posted_notes" }, "parameters": [ { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination cursor, leave empty for first request, pass cursor value from previous response for next page\n - The cursor is usually the note_id of the last note in the notes list\n - JSON path example: `$.data.data.notes[-1].cursor`", "default": "", "title": "Cursor" }, "description": "Pagination cursor, leave empty for first request, pass cursor value from previous response for next page\n - The cursor is usually the note_id of the last note in the notes list\n - JSON path example: `$.data.data.notes[-1].cursor`", "example": "" }, { "name": "share_text", "in": "query", "required": false, "schema": { "type": "string", "description": "Share link, supports xiaohongshu.com, xhslink.com, xhslink.cn\n\nUsage: Xiaohongshu sharing link, supports APP and Web sharing links, including `xiaohongshu.com` full links, `xhslink.com` and `xhslink.cn` short links", "default": "", "title": "Share Text" }, "description": "Share link, supports xiaohongshu.com, xhslink.com, xhslink.cn\n\nUsage: Xiaohongshu sharing link, supports APP and Web sharing links, including `xiaohongshu.com` full links, `xhslink.com` and `xhslink.cn` short links", "example": "http://xhslink.com/o/8GqargIxrko" }, { "name": "user_id", "in": "query", "required": false, "schema": { "type": "string", "description": "User ID, e.g. \"61b46d790000000010008153\"", "default": "", "title": "User Id" }, "description": "User ID, e.g. \"61b46d790000000010008153\"", "example": "61b46d790000000010008153" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:bedf8a542cdd9d60433f9f007a958b41afdd191a3914902d4ba8eda9e33f7cbc" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-xiaohongshu-app_v2-get_user_posted_notes" } }, "/apis/v1/tikhub/xiaohongshu/app_v2/get_video_note_detail": { "get": { "description": "Xiaohongshu (app_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get full detail data of a video note\n\n### ⚠️ Note Type Notice (Important)\n- Xiaohongshu notes come in two types: `image notes (normal)` and `video notes (video)`. Make sure to distinguish them when using the APIs.\n- This endpoint can **ONLY fetch data of video notes**. Passing the note_id of an image note will fail to get any content. This restriction comes from Xiaohongshu official.\n- The image note endpoint `/tikhub/xiaohongshu/app_v2/get_image_note_detail` can fetch both image and video notes, but for video notes it will NOT return the video play URL, only the video cover image.\n\n### Recommended Workflow (when note type is unknown)\n- 1. Request `/tikhub/xiaohongshu/app_v2/get_image_note_detail` (image note endpoint) first.\n- 2. Check the note type field in the response (e.g. whether `type` is `video`) to determine if it is a video note.\n- 3. If it is a video note, request this endpoint again with the same note_id to get the video play URL.\n\n### ⚠️ Billing Notice\n- If a wrong or non-existent note ID is passed (or the share link fails to parse), the endpoint still responds normally, but the `data` field will contain an upstream \"service error\" message. Such requests **will still be billed as normal**. Please make sure the parameters are valid before calling.\n\n### Parameters\n- note_id: Note ID, e.g. \"697c0eee000000000a03c308\"\n- share_text: Xiaohongshu sharing link, supports APP and Web sharing links, including `xiaohongshu.com` full links, `xhslink.com` and `xhslink.cn` short links\n- Prefer to use `note_id`, if not, use `share_text`, one of the two parameters is required, if both are carried, `note_id` shall prevail.\n\n### Return\n- Video note detail data, including video play URL, cover image, author info, interaction data, etc.\n\nAPI references: `get_image_note_detail` = `GET /tikhub/xiaohongshu/app_v2/get_image_note_detail` (operationId: `get_tikhub_xiaohongshu_app_v2_get_image_note_detail`).\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_xiaohongshu_app_v2_get_video_note_detail", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Video note detail data, including video play URL, cover image, author info, interaction data, etc.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "xiaohongshu get_video_note_detail", "tags": [ "tikhub.xiaohongshu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "934565c3bf9a" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/xiaohongshu/app_v2/get_video_note_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_xiaohongshu_app_v2_get_video_note_detail", "method": "GET", "path": "/apis/v1/tikhub/xiaohongshu/app_v2/get_video_note_detail" }, "parameters": [ { "name": "note_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Note ID, e.g. \"697c0eee000000000a03c308\"", "default": "", "title": "Note Id" }, "description": "Note ID, e.g. \"697c0eee000000000a03c308\"", "example": "697c0eee000000000a03c308" }, { "name": "share_text", "in": "query", "required": false, "schema": { "type": "string", "description": "Share link, supports xiaohongshu.com, xhslink.com, xhslink.cn\n\nUsage: Xiaohongshu sharing link, supports APP and Web sharing links, including `xiaohongshu.com` full links, `xhslink.com` and `xhslink.cn` short links", "default": "", "title": "Share Text" }, "description": "Share link, supports xiaohongshu.com, xhslink.com, xhslink.cn\n\nUsage: Xiaohongshu sharing link, supports APP and Web sharing links, including `xiaohongshu.com` full links, `xhslink.com` and `xhslink.cn` short links", "example": "http://xhslink.com/o/8GqargIxrko" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:34032c8d897158a4eb02596d88905bc4b4dbc06ae4036bb5e69e3daf2cec2500" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-xiaohongshu-app_v2-get_video_note_detail" } }, "/apis/v1/tikhub/xiaohongshu/app_v2/search_groups": { "get": { "description": "Xiaohongshu (app_v2).\n\n### Purpose\n- Search Xiaohongshu groups by keyword, supports pagination\n\n### Parameters\n- keyword: Search keyword (required), e.g. \"Shanghai\"\n- page_no: Page number, start from 0\n- search_id: Search ID, pass value from first search response for pagination\n- source: Source, default \"unifiedSearchGroup\"\n- is_recommend: Is recommend, 0=no, 1=yes\n\n### Return\n- Search result data, including group list and pagination info\n\n### Pagination Guide\n- First request: leave search_id empty (auto-generated), page_no pass 0\n- Next page: pass search_id from first search response, increment page_no\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_xiaohongshu_app_v2_search_groups", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Search result data, including group list and pagination info", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "xiaohongshu search_groups", "tags": [ "tikhub.xiaohongshu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "d342189387c2" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/xiaohongshu/app_v2/search_groups", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_xiaohongshu_app_v2_search_groups", "method": "GET", "path": "/apis/v1/tikhub/xiaohongshu/app_v2/search_groups" }, "parameters": [ { "name": "is_recommend", "in": "query", "required": false, "schema": { "type": "integer", "description": "Is recommended: 0=no, 1=yes", "default": 0, "title": "Is Recommend" }, "description": "Is recommended: 0=no, 1=yes", "example": 0 }, { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Search keyword", "title": "Keyword" }, "description": "Search keyword", "example": "Shanghai" }, { "name": "page_no", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page number, start from 0", "default": 0, "title": "Page No" }, "description": "Page number, start from 0", "example": 0 }, { "name": "search_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Search ID, pass value from first search response for pagination", "default": "", "title": "Search Id" }, "description": "Search ID, pass value from first search response for pagination", "example": "" }, { "name": "source", "in": "query", "required": false, "schema": { "type": "string", "description": "Source, default \"unifiedSearchGroup\"", "default": "unifiedSearchGroup", "title": "Source" }, "description": "Source, default \"unifiedSearchGroup\"", "example": "unifiedSearchGroup" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:26ae8402efe30783a49bd973a02e3be5408b9418fae2445b7a94140bc62c6326" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/xiaohongshu/app_v2/search_groups?is_recommend=0&keyword=Shanghai&page_no=0&search_id=&source=unifiedSearchGroup' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-xiaohongshu-app_v2-search_groups" } }, "/apis/v1/tikhub/xiaohongshu/app_v2/search_images": { "get": { "description": "Xiaohongshu (app_v2).\n\n### Purpose\n- Search Xiaohongshu images by keyword, returns 20 results per page, supports pagination\n\n### Parameters\n- keyword: Search keyword (required), e.g. \"wallpaper\"\n- page: Page number, start from 1\n- search_id: Search ID, pass value from first search response for pagination\n- search_session_id: Search session ID, pass value from first search response for pagination\n- word_request_id: Word request ID, pass value from first search response for pagination\n- source: Source, default \"explore_feed\"\n\n### Return\n- Search result data, including image list and pagination info\n\n### Pagination Guide\n- First request: only pass keyword and page\n- Next page: pass search_id, search_session_id, and word_request_id from first search response\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_xiaohongshu_app_v2_search_images", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Search result data, including image list and pagination info", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "xiaohongshu search_images", "tags": [ "tikhub.xiaohongshu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "546ca6f2be52" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/xiaohongshu/app_v2/search_images", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_xiaohongshu_app_v2_search_images", "method": "GET", "path": "/apis/v1/tikhub/xiaohongshu/app_v2/search_images" }, "parameters": [ { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Search keyword", "title": "Keyword" }, "description": "Search keyword", "example": "Wallpaper" }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page number, start from 1", "default": 1, "title": "Page" }, "description": "Page number, start from 1", "example": 1 }, { "name": "search_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Search ID, pass value from first search response for pagination", "default": "", "title": "Search Id" }, "description": "Search ID, pass value from first search response for pagination", "example": "" }, { "name": "search_session_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Search session ID, pass value from first search response for pagination", "default": "", "title": "Search Session Id" }, "description": "Search session ID, pass value from first search response for pagination", "example": "" }, { "name": "source", "in": "query", "required": false, "schema": { "type": "string", "description": "Source, default \"explore_feed\"", "default": "explore_feed", "title": "Source" }, "description": "Source, default \"explore_feed\"", "example": "explore_feed" }, { "name": "word_request_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Word request ID, pass value from first search response for pagination", "default": "", "title": "Word Request Id" }, "description": "Word request ID, pass value from first search response for pagination", "example": "" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:f5e7781395671fb2d5d7a5470f2a1f27d1cfb819a9ce327607d2ca08d99dde8f" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/xiaohongshu/app_v2/search_images?keyword=Wallpaper&page=1&search_id=&search_session_id=&source=explore_feed&word_request_id=' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-xiaohongshu-app_v2-search_images" } }, "/apis/v1/tikhub/xiaohongshu/app_v2/search_notes": { "get": { "description": "Xiaohongshu (app_v2).\n\n### Purpose\n- Search Xiaohongshu notes by keyword, supports multiple sort types, note type filters, and time filters\n\n### Parameters\n- keyword: Search keyword (required), e.g. \"food recommendations\"\n- page: Page number, start from 1\n- sort_type: Sort type\n - \"general\": General sort (default)\n - \"time_descending\": Sort by time descending (latest)\n - \"popularity_descending\": Sort by like count (most liked)\n - \"comment_descending\": Sort by comment count (most commented)\n - \"collect_descending\": Sort by collect count (most collected)\n - \"english_preferred\": English preferred\n- note_type: Note type filter\n - \"不限\": All types (default)\n - \"视频笔记\": Video notes only\n - \"普通笔记\": Image notes only\n - \"直播笔记\": Live notes only\n- time_filter: Time filter\n - \"不限\": All time (default)\n - \"一天内\": Within 24 hours\n - \"一周内\": Within 7 days\n - \"半年内\": Within 6 months\n- search_id: Search ID, pass value from first search response for pagination\n- search_session_id: Search session ID, pass value from first search response for pagination\n- source: Source, default \"explore_feed\"\n- ai_mode: AI mode, 0=off, 1=on\n\n### Return\n- Search result data, including note list and pagination info\n\n### Pagination Guide\n- First request: only pass keyword and page\n- Next page: pass search_id and search_session_id from first search response\n\nPass note_type and time_filter using the literal Chinese values listed above.\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_xiaohongshu_app_v2_search_notes", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Search result data, including note list and pagination info", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "xiaohongshu search_notes", "tags": [ "tikhub.xiaohongshu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "216c1c520363" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/xiaohongshu/app_v2/search_notes", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_xiaohongshu_app_v2_search_notes", "method": "GET", "path": "/apis/v1/tikhub/xiaohongshu/app_v2/search_notes" }, "parameters": [ { "name": "ai_mode", "in": "query", "required": false, "schema": { "type": "integer", "description": "AI mode: 0=off, 1=on", "default": 0, "title": "Ai Mode" }, "description": "AI mode: 0=off, 1=on", "example": 0 }, { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Search keyword", "title": "Keyword" }, "description": "Search keyword", "example": "Food Recommendations" }, { "name": "note_type", "in": "query", "required": false, "schema": { "type": "string", "description": "Note type filter. Use the literal Chinese values: \"不限\"=all types (default), \"视频笔记\"=video notes, \"普通笔记\"=image notes, \"直播笔记\"=live notes.", "default": "不限", "title": "Note Type" }, "description": "Note type filter. Use the literal Chinese values: \"不限\"=all types (default), \"视频笔记\"=video notes, \"普通笔记\"=image notes, \"直播笔记\"=live notes.", "example": "不限" }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page number, start from 1", "default": 1, "title": "Page" }, "description": "Page number, start from 1", "example": 1 }, { "name": "search_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Search ID, pass value from first search response for pagination", "default": "", "title": "Search Id" }, "description": "Search ID, pass value from first search response for pagination", "example": "" }, { "name": "search_session_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Search session ID, pass value from first search response for pagination", "default": "", "title": "Search Session Id" }, "description": "Search session ID, pass value from first search response for pagination", "example": "" }, { "name": "sort_type", "in": "query", "required": false, "schema": { "type": "string", "description": "Sort type\n - \"general\": General sort (default)\n - \"time_descending\": Sort by time descending (latest)\n - \"popularity_descending\": Sort by like count (most liked)\n - \"comment_descending\": Sort by comment count (most commented)\n - \"collect_descending\": Sort by collect count (most collected)\n - \"english_preferred\": English preferred", "default": "general", "title": "Sort Type" }, "description": "Sort type\n - \"general\": General sort (default)\n - \"time_descending\": Sort by time descending (latest)\n - \"popularity_descending\": Sort by like count (most liked)\n - \"comment_descending\": Sort by comment count (most commented)\n - \"collect_descending\": Sort by collect count (most collected)\n - \"english_preferred\": English preferred", "example": "general" }, { "name": "source", "in": "query", "required": false, "schema": { "type": "string", "description": "Source, default \"explore_feed\"", "default": "explore_feed", "title": "Source" }, "description": "Source, default \"explore_feed\"", "example": "explore_feed" }, { "name": "time_filter", "in": "query", "required": false, "schema": { "type": "string", "description": "Publication-time filter. Use the literal Chinese values: \"不限\"=all time (default), \"一天内\"=within 24 hours, \"一周内\"=within 7 days, \"半年内\"=within 6 months.", "default": "不限", "title": "Time Filter" }, "description": "Publication-time filter. Use the literal Chinese values: \"不限\"=all time (default), \"一天内\"=within 24 hours, \"一周内\"=within 7 days, \"半年内\"=within 6 months.", "example": "不限" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:aa83f35034ab294edb0c8e812e7c66ed50059ca65c31076198a45b9cdddb90c9" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/xiaohongshu/app_v2/search_notes?ai_mode=0&keyword=Food+Recommendations¬e_type=%E4%B8%8D%E9%99%90&page=1&search_id=&search_session_id=&sort_type=general&source=explore_feed&time_filter=%E4%B8%8D%E9%99%90' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-xiaohongshu-app_v2-search_notes" } }, "/apis/v1/tikhub/xiaohongshu/app_v2/search_products": { "get": { "description": "Xiaohongshu (app_v2).\n\n### Purpose\n- Search Xiaohongshu products by keyword, returns 20 results per page, supports pagination\n\n### Parameters\n- keyword: Search keyword (required), e.g. \"phone case\"\n- page: Page number, start from 1\n- search_id: Search ID, pass value from first search response for pagination\n- source: Source, default \"explore_feed\"\n\n### Return\n- Search result data, including product list and pagination info\n\n### Pagination Guide\n- First request: only pass keyword and page\n- Next page: pass search_id from first search response\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_xiaohongshu_app_v2_search_products", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Search result data, including product list and pagination info", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "xiaohongshu search_products", "tags": [ "tikhub.xiaohongshu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "7fd8c88c52ac" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/xiaohongshu/app_v2/search_products", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_xiaohongshu_app_v2_search_products", "method": "GET", "path": "/apis/v1/tikhub/xiaohongshu/app_v2/search_products" }, "parameters": [ { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Search keyword", "title": "Keyword" }, "description": "Search keyword", "example": "Phone case" }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page number, start from 1", "default": 1, "title": "Page" }, "description": "Page number, start from 1", "example": 1 }, { "name": "search_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Search ID, pass value from first search response for pagination", "default": "", "title": "Search Id" }, "description": "Search ID, pass value from first search response for pagination", "example": "" }, { "name": "source", "in": "query", "required": false, "schema": { "type": "string", "description": "Source, default \"explore_feed\"", "default": "explore_feed", "title": "Source" }, "description": "Source, default \"explore_feed\"", "example": "explore_feed" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:fdc2570004516e5a28b934089c2675f982e9c89770907d654c4c5f5b1af9367d" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/xiaohongshu/app_v2/search_products?keyword=Phone+case&page=1&search_id=&source=explore_feed' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-xiaohongshu-app_v2-search_products" } }, "/apis/v1/tikhub/xiaohongshu/app_v2/search_users": { "get": { "description": "Xiaohongshu (app_v2).\n\n### Purpose\n- Search Xiaohongshu users by keyword, returns 20 results per page, supports pagination\n\n### Parameters\n- keyword: Search keyword (required), e.g. \"food creator\"\n- page: Page number, start from 1\n- search_id: Search ID, pass value from first search response for pagination\n- source: Source, default \"explore_feed\"\n\n### Return\n- Search result data, including user list and pagination info\n\n### Pagination Guide\n- First request: only pass keyword and page\n- Next page: pass search_id from first search response\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_xiaohongshu_app_v2_search_users", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Search result data, including user list and pagination info", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "xiaohongshu search_users", "tags": [ "tikhub.xiaohongshu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "03dfdff27a71" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/xiaohongshu/app_v2/search_users", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_xiaohongshu_app_v2_search_users", "method": "GET", "path": "/apis/v1/tikhub/xiaohongshu/app_v2/search_users" }, "parameters": [ { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Search keyword", "title": "Keyword" }, "description": "Search keyword", "example": "Food Blogger" }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page number, start from 1", "default": 1, "title": "Page" }, "description": "Page number, start from 1", "example": 1 }, { "name": "search_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Search ID, pass value from first search response for pagination", "default": "", "title": "Search Id" }, "description": "Search ID, pass value from first search response for pagination", "example": "" }, { "name": "source", "in": "query", "required": false, "schema": { "type": "string", "description": "Source, default \"explore_feed\"", "default": "explore_feed", "title": "Source" }, "description": "Source, default \"explore_feed\"", "example": "explore_feed" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:f8b2e04e2080e86080945ff2c56cebccc19c7f44ca90f2c0db49893cd9ae089b" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/xiaohongshu/app_v2/search_users?keyword=Food+Blogger&page=1&search_id=&source=explore_feed' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-xiaohongshu-app_v2-search_users" } }, "/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_core_data": { "post": { "description": "Xiaohongshu (pgy). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Daily trend and period summary of a blogger, for plotting performance charts\n\n### Request Body Parameters\n- user_id: **required**, blogger user ID\n- business: 0=organic (default), 1=sponsored\n- note_type: 3=image-text+video (default), 1=image-text, 2=video\n **Warning**: differs from the upstream V1 note-list endpoint (not exposed in this specification), where 4=all and 3=sponsored\n- date_type: 1=last 30 days (default), 2=last 90 days\n- advertise_switch: 1=all traffic (default), 0=organic only\n\n### Return\n- dailyData[]: daily data points\n- sumData: period aggregates (impressions / reads / engagements / CPM / CPE)\n\n### Response shape (two layers)\n- `resp[\"data\"]` is PGY's raw envelope (with `code`/`msg`/`success`); the payload is one level deeper\n- Correct access: `data = resp[\"data\"][\"data\"]` — every field listed under \"Return\" lives here\n\n### Billing\n- HTTP 200 → **charged**, including \"no result\" (`data` is null, e.g. ID not found or filters matched\n nothing): the request did reach PGY, so retrying on empty data just burns quota\n- HTTP 400 → not charged (malformed params, or upstream unavailable/error)\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_xiaohongshu_pgy_get_blogger_core_data", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- dailyData[]: daily data points\n- sumData: period aggregates (impressions / reads / engagements / CPM / CPE)\n\n### Response shape (two layers)\n- `resp[\"data\"]` is PGY's raw envelope (with `code`/`msg`/`success`); the payload is one level deeper\n- Correct access: `data = resp[\"data\"][\"data\"]` — every field listed under \"Return\" lives here", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "xiaohongshu get_blogger_core_data", "tags": [ "tikhub.xiaohongshu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "fb61f012cd85" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/xiaohongshu/pgy/get_blogger_core_data", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_xiaohongshu_pgy_get_blogger_core_data", "method": "POST", "path": "/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_core_data" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "user_id": { "type": "string", "title": "User Id", "description": "Blogger user ID", "example": "5c668b3e0000000012021605" }, "business": { "type": "integer", "enum": [ 0, 1 ], "title": "Business", "description": "Note scope: 0=Organic notes (default), 1=Sponsored notes", "default": 0, "example": 0 }, "note_type": { "type": "integer", "enum": [ 1, 2, 3 ], "title": "Note Type", "description": "Note type: 3=Image & text + Video (default), 1=Image & text, 2=Video\n\nUsage: 3=image-text+video (default), 1=image-text, 2=video\n **Warning**: differs from the upstream V1 note-list endpoint (not exposed in this specification), where 4=all and 3=sponsored", "default": 3, "example": 3 }, "date_type": { "type": "integer", "enum": [ 1, 2 ], "title": "Date Type", "description": "Date range: 1=last 30 days (default), 2=last 90 days", "default": 1, "example": 1 }, "advertise_switch": { "type": "integer", "enum": [ 0, 1 ], "title": "Advertise Switch", "description": "Traffic type: 1=All (including sponsored), 0=Organic only\n\nUsage: 1=all traffic (default), 0=organic only", "default": 1, "example": 1 } }, "additionalProperties": false, "type": "object", "required": [ "user_id" ], "title": "CoreDataReq" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:245fb0fc77d3ceeb62e970f6431b1b888594664e6fe8a83528c34e8bf9947614" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_core_data \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"user_id\": \"5c668b3e0000000012021605\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-xiaohongshu-pgy-get_blogger_core_data" } }, "/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_data_summary": { "post": { "description": "Xiaohongshu (pgy). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Account-level data summary of a blogger\n\n### Request Body Parameters\n- user_id: **required**, blogger user ID\n- business: 0=organic (default), 1=sponsored\n\n### Return\n- Cost/quote estimates: estimatePictureCpm / estimateVideoCpm / pictureReadCost\n- Service metrics: active days in last 7d, 48h invitation reply rate\n- Growth: fans change rate and percentile vs peers\n\n### Response shape (two layers)\n- `resp[\"data\"]` is PGY's raw envelope (with `code`/`msg`/`success`); the payload is one level deeper\n- Correct access: `data = resp[\"data\"][\"data\"]` — every field listed under \"Return\" lives here\n\n### Billing\n- HTTP 200 → **charged**, including \"no result\" (`data` is null, e.g. ID not found or filters matched\n nothing): the request did reach PGY, so retrying on empty data just burns quota\n- HTTP 400 → not charged (malformed params, or upstream unavailable/error)\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_xiaohongshu_pgy_get_blogger_data_summary", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Cost/quote estimates: estimatePictureCpm / estimateVideoCpm / pictureReadCost\n- Service metrics: active days in last 7d, 48h invitation reply rate\n- Growth: fans change rate and percentile vs peers\n\n### Response shape (two layers)\n- `resp[\"data\"]` is PGY's raw envelope (with `code`/`msg`/`success`); the payload is one level deeper\n- Correct access: `data = resp[\"data\"][\"data\"]` — every field listed under \"Return\" lives here", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "xiaohongshu get_blogger_data_summary", "tags": [ "tikhub.xiaohongshu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "b29bb4cfd9ff" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/xiaohongshu/pgy/get_blogger_data_summary", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_xiaohongshu_pgy_get_blogger_data_summary", "method": "POST", "path": "/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_data_summary" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "user_id": { "type": "string", "title": "User Id", "description": "Blogger user ID", "example": "5c668b3e0000000012021605" }, "business": { "type": "integer", "enum": [ 0, 1 ], "title": "Business", "description": "Note scope: 0=Organic notes (default), 1=Sponsored notes", "default": 0, "example": 0 } }, "additionalProperties": false, "type": "object", "required": [ "user_id" ], "title": "DataSummaryReq" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:56342ea88984d998643fcf96a9117b761612e0031290dbe0943cdbdd6f6d1494" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_data_summary \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"user_id\": \"5c668b3e0000000012021605\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-xiaohongshu-pgy-get_blogger_data_summary" } }, "/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_detail": { "post": { "description": "Xiaohongshu (pgy). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get full profile of a single blogger (PGY blogger homepage header)\n- The response already embeds many metrics, so other blogger endpoints are often unnecessary\n\n### Request Body Parameters\n- user_id: Blogger user ID, e.g. \"5c668b3e0000000012021605\"\n\n### Return\n- Profile: userId / name / redId / headPhoto / location / personalTags\n- Commercial: image-text & video quotes, cooperation status, MCN agency\n- Tags: contentTags / featureTags\n- Metrics: fans count, medians, last-30d impressions\n\n### Response shape (two layers)\n- `resp[\"data\"]` is PGY's raw envelope (with `code`/`msg`/`success`); the payload is one level deeper\n- Correct access: `data = resp[\"data\"][\"data\"]` — every field listed under \"Return\" lives here\n\n### Billing\n- HTTP 200 → **charged**, including \"no result\" (`data` is null, e.g. ID not found or filters matched\n nothing): the request did reach PGY, so retrying on empty data just burns quota\n- HTTP 400 → not charged (malformed params, or upstream unavailable/error)\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_xiaohongshu_pgy_get_blogger_detail", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Profile: userId / name / redId / headPhoto / location / personalTags\n- Commercial: image-text & video quotes, cooperation status, MCN agency\n- Tags: contentTags / featureTags\n- Metrics: fans count, medians, last-30d impressions\n\n### Response shape (two layers)\n- `resp[\"data\"]` is PGY's raw envelope (with `code`/`msg`/`success`); the payload is one level deeper\n- Correct access: `data = resp[\"data\"][\"data\"]` — every field listed under \"Return\" lives here", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "xiaohongshu get_blogger_detail", "tags": [ "tikhub.xiaohongshu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "fa98185b2ca2" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/xiaohongshu/pgy/get_blogger_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_xiaohongshu_pgy_get_blogger_detail", "method": "POST", "path": "/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_detail" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "user_id": { "type": "string", "title": "User Id", "description": "Blogger user ID", "example": "5c668b3e0000000012021605" } }, "additionalProperties": false, "type": "object", "required": [ "user_id" ], "title": "UserIdReq" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:1f3f5c38d7c78e0980aaf835f13aa6b637e4567d34dec937e5e84ea04f7a1e43" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_detail \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"user_id\": \"5c668b3e0000000012021605\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-xiaohongshu-pgy-get_blogger_detail" } }, "/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_fans_history": { "post": { "description": "Xiaohongshu (pgy). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Fans growth curve over time (\"Fans Analysis → Fans Trend\")\n\n### Request Body Parameters\n- user_id: **required**, blogger user ID\n- increase_type: 1=**cumulative total** (default), 2=**daily increment**\n- date_type: 1=last 30 days (default), 2=last 60 days\n\n### Return\n- list[]: daily data points\n- fansNumInc: net growth over the period\n- fansNumIncRate: growth rate over the period\n\n### Tip\n- Defaults match the PGY web page (cumulative total + last 30 days)\n- Pass increase_type=2 for the daily-increment curve\n\n### Response shape (two layers)\n- `resp[\"data\"]` is PGY's raw envelope (with `code`/`msg`/`success`); the payload is one level deeper\n- Correct access: `data = resp[\"data\"][\"data\"]` — every field listed under \"Return\" lives here\n\n### Billing\n- HTTP 200 → **charged**, including \"no result\" (`data` is null, e.g. ID not found or filters matched\n nothing): the request did reach PGY, so retrying on empty data just burns quota\n- HTTP 400 → not charged (malformed params, or upstream unavailable/error)\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_xiaohongshu_pgy_get_blogger_fans_history", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- list[]: daily data points\n- fansNumInc: net growth over the period\n- fansNumIncRate: growth rate over the period\n\n### Response shape (two layers)\n- `resp[\"data\"]` is PGY's raw envelope (with `code`/`msg`/`success`); the payload is one level deeper\n- Correct access: `data = resp[\"data\"][\"data\"]` — every field listed under \"Return\" lives here", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "xiaohongshu get_blogger_fans_history", "tags": [ "tikhub.xiaohongshu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "f7c0e3819e2d" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/xiaohongshu/pgy/get_blogger_fans_history", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_xiaohongshu_pgy_get_blogger_fans_history", "method": "POST", "path": "/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_fans_history" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "user_id": { "type": "string", "title": "User Id", "description": "Blogger user ID", "example": "5c668b3e0000000012021605" }, "increase_type": { "type": "integer", "enum": [ 1, 2 ], "title": "Increase Type", "description": "Curve: 1=total followers (default, cumulative), 2=daily follower increment", "default": 1, "example": 1 }, "date_type": { "type": "integer", "enum": [ 1, 2 ], "title": "Date Type", "description": "Date range: 1=last 30 days (default), 2=last 60 days", "default": 1, "example": 1 } }, "additionalProperties": false, "type": "object", "required": [ "user_id" ], "title": "FansHistoryReq" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e9d25196924bd5059e43268f023beb3107cb5a4f8ee7452da1100adc6d096041" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_fans_history \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"user_id\": \"5c668b3e0000000012021605\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-xiaohongshu-pgy-get_blogger_fans_history" } }, "/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_fans_profile": { "post": { "description": "Xiaohongshu (pgy). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Audience distribution of a blogger's fans, to check fit with the target audience\n\n### Request Body Parameters\n- user_id: Blogger user ID\n\n### Return\n- ages[] / gender (male, female) / provinces[] / cities[] / devices[] / interests[]\n\n### Response shape (two layers)\n- `resp[\"data\"]` is PGY's raw envelope (with `code`/`msg`/`success`); the payload is one level deeper\n- Correct access: `data = resp[\"data\"][\"data\"]` — every field listed under \"Return\" lives here\n\n### Billing\n- HTTP 200 → **charged**, including \"no result\" (`data` is null, e.g. ID not found or filters matched\n nothing): the request did reach PGY, so retrying on empty data just burns quota\n- HTTP 400 → not charged (malformed params, or upstream unavailable/error)\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_xiaohongshu_pgy_get_blogger_fans_profile", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- ages[] / gender (male, female) / provinces[] / cities[] / devices[] / interests[]\n\n### Response shape (two layers)\n- `resp[\"data\"]` is PGY's raw envelope (with `code`/`msg`/`success`); the payload is one level deeper\n- Correct access: `data = resp[\"data\"][\"data\"]` — every field listed under \"Return\" lives here", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "xiaohongshu get_blogger_fans_profile", "tags": [ "tikhub.xiaohongshu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "71a50ae0b262" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/xiaohongshu/pgy/get_blogger_fans_profile", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_xiaohongshu_pgy_get_blogger_fans_profile", "method": "POST", "path": "/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_fans_profile" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "user_id": { "type": "string", "title": "User Id", "description": "Blogger user ID", "example": "5c668b3e0000000012021605" } }, "additionalProperties": false, "type": "object", "required": [ "user_id" ], "title": "UserIdReq" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:ab9ac329d071ba2fd91b4f65a9a7f9c2825ddd35cd47e8f1106bbdb6b6b095c4" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_fans_profile \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"user_id\": \"5c668b3e0000000012021605\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-xiaohongshu-pgy-get_blogger_fans_profile" } }, "/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_fans_summary": { "post": { "description": "Xiaohongshu (pgy). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Core fans metrics of a blogger (\"Fans Analysis → Core Metrics\")\n\n### Request Body Parameters\n- user_id: Blogger user ID\n\n### Return\n- fansNum / fansIncreaseNum / fansGrowthRate\n- activeFansRate / reading fans ratio / engaging fans ratio\n- Percentile vs peers (e.g. activeFansBeyondRate)\n\n### Response shape (two layers)\n- `resp[\"data\"]` is PGY's raw envelope (with `code`/`msg`/`success`); the payload is one level deeper\n- Correct access: `data = resp[\"data\"][\"data\"]` — every field listed under \"Return\" lives here\n\n### Billing\n- HTTP 200 → **charged**, including \"no result\" (`data` is null, e.g. ID not found or filters matched\n nothing): the request did reach PGY, so retrying on empty data just burns quota\n- HTTP 400 → not charged (malformed params, or upstream unavailable/error)\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_xiaohongshu_pgy_get_blogger_fans_summary", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- fansNum / fansIncreaseNum / fansGrowthRate\n- activeFansRate / reading fans ratio / engaging fans ratio\n- Percentile vs peers (e.g. activeFansBeyondRate)\n\n### Response shape (two layers)\n- `resp[\"data\"]` is PGY's raw envelope (with `code`/`msg`/`success`); the payload is one level deeper\n- Correct access: `data = resp[\"data\"][\"data\"]` — every field listed under \"Return\" lives here", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "xiaohongshu get_blogger_fans_summary", "tags": [ "tikhub.xiaohongshu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "e807c9718f5a" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/xiaohongshu/pgy/get_blogger_fans_summary", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_xiaohongshu_pgy_get_blogger_fans_summary", "method": "POST", "path": "/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_fans_summary" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "user_id": { "type": "string", "title": "User Id", "description": "Blogger user ID", "example": "5c668b3e0000000012021605" } }, "additionalProperties": false, "type": "object", "required": [ "user_id" ], "title": "UserIdReq" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:15c4e22bdc9ffeaaa9afca9908b6d5633605d3e3eb88b405cba03b4f071780e2" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_fans_summary \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"user_id\": \"5c668b3e0000000012021605\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-xiaohongshu-pgy-get_blogger_fans_summary" } }, "/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_filter_options": { "post": { "description": "Xiaohongshu (pgy). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\nFetch the tree-style option dictionaries used by /tikhub/xiaohongshu/pgy/get_blogger_list. Values are maintained by the platform and can change; cache the response and reuse it instead of calling before every search. Copy dictionary labels verbatim, including required Chinese strings.\n\n### Request body\nNo parameters; send an empty JSON object if supplying a body.\n\n### Return and response access\nThe raw envelope (code, msg, success) is in response.data; dictionaries are in response.data.data.\n- contentTags: creator categories, including level-2 categories; feeds blogger.content_tag.\n- contentScenes: note categories; feeds blogger.note_scene.\n- areas: creator locations down to district level; fansAreas: audience locations down to city level.\n- industryTags: industry taxonomy (taxonomy1Tag / taxonomy2Tags), used by coop.industry and flags.industry_first. This differs from creator categories.\n- personalTagsV2: creator personas; featureTags: specialty content; contentTheme: content themes.\n- audience20: audience segments; automotiveIndustryTag: industry-specific audience profiles.\n- consumerBehavior: estimated consumer behavior; may be null for some accounts.\n- market: marketing goals; activities: campaign options, whose code values feed flags.activity_codes.\n\n### Upstream billing\nUpstream HTTP 200 responses are charged even if the data is null or no creators match; do not retry solely because data is empty. Upstream HTTP 400 responses are not charged. Use an AIsa price quote for gateway billing.\n\nAPI references: `get_blogger_list` = `POST /tikhub/xiaohongshu/pgy/get_blogger_list` (operationId: `post_tikhub_xiaohongshu_pgy_get_blogger_list`).\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_xiaohongshu_pgy_get_blogger_filter_options", "responses": { "200": { "description": "Successful Response\n\n### Return and response access\nThe raw envelope (code, msg, success) is in response.data; dictionaries are in response.data.data.\n- contentTags: creator categories, including level-2 categories; feeds blogger.content_tag.\n- contentScenes: note categories; feeds blogger.note_scene.\n- areas: creator locations down to district level; fansAreas: audience locations down to city level.\n- industryTags: industry taxonomy (taxonomy1Tag / taxonomy2Tags), used by coop.industry and flags.industry_first. This differs from creator categories.\n- personalTagsV2: creator personas; featureTags: specialty content; contentTheme: content themes.\n- audience20: audience segments; automotiveIndustryTag: industry-specific audience profiles.\n- consumerBehavior: estimated consumer behavior; may be null for some accounts.\n- market: marketing goals; activities: campaign options, whose code values feed flags.activity_codes.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "xiaohongshu get_blogger_filter_options", "tags": [ "tikhub.xiaohongshu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "06e5da2f1d4f" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/xiaohongshu/pgy/get_blogger_filter_options", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_xiaohongshu_pgy_get_blogger_filter_options", "method": "POST", "path": "/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_filter_options" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:97dd41ea905273f75401fa4bbb41fdc7b02130b9945620fd17b9e3952599a0b0" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-xiaohongshu-pgy-get_blogger_filter_options" } }, "/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_list": { "post": { "description": "Xiaohongshu (pgy).\n\n### Purpose\nSearch PGY note creators by keyword and about 60 filters in seven groups: goal (marketing goals), blogger (creator attributes), fans (audience profiles), note (organic note metrics), coop (sponsored note metrics), live (live-stream metrics), and flags (recommendation and exclusion switches). Results contain about 140 fields, so separate creator-detail calls are often unnecessary.\n\n### Search and sorting\n- keyword: Empty means filtering without a text search.\n- search_type: 1 searches note keywords (default); 0 searches creator nicknames.\n- column: One of the 34 sort keys listed in the request schema. The default is comprehensiverank.\n- sort: desc (default) or asc.\n- brand_user_id: Optional advertiser ID for personalized recommendations and prior-cooperation markers.\n- similar_user_id: Find similar creators while retaining all other filters. The separate /tikhub/xiaohongshu/pgy/get_blogger_similar endpoint does not support these filters and returns at most four creators per page.\n- similar_word: Optional nickname for display; it does not change results.\n\n### Filter values\nUse the exact enum values in the schema. Dictionary-backed labels must be copied verbatim from /tikhub/xiaohongshu/pgy/get_blogger_filter_options; Chinese labels are protocol values and must not be translated. Cache and reuse this dictionary.\n- blogger.content_tag: contentTags; mix level-1 and level-2 names in one flat array. Use the parent name to select an entire category. Expanding all children can miss creators tagged only at the parent level. Omit the field for unrestricted categories.\n- blogger.personal_tags: personalTagsV2; copy tagName at any available level.\n- blogger.feature_tags: featureTags; mix level-1 and level-2 names.\n- blogger.location: areas; province, city, and district names may be mixed. fans.location uses fansAreas and supports provinces and cities, without districts.\n- blogger.content_theme: contentTheme; level-1 labels only.\n- blogger.audience20: audience20; use a bare level-1 name or a level-2 value formatted as \" -\". A bare level-2 label returns zero results.\n- blogger.note_scene: contentScenes; use the complete space-separated path including the root. A path may stop at any depth; a bare leaf returns zero results.\n- blogger.consumer_behavior: consumerBehavior; use the complete space-separated path including the root. Bare leaf values can silently disable this filter and return unfiltered results. Compare totals with and without the filter; a null dictionary value means this feature is unavailable to the account.\n- blogger.industry_crowd: automotiveIndustryTag; use the deepest leaf's numeric value, not its label.\n- flags.industry_first / industry_second: industryTags; one bare label per field. This taxonomy differs from creator categories.\n- flags.activity_codes: activities; copy each item's code.\nArrays combine values with OR and remove duplicates; at most 30 items, with at most 64 characters per item. Across different filters the conditions are combined.\nRanges use {\"min\": value, \"max\": value}. Omitted min means zero and omitted max means unbounded; an entirely empty range returns HTTP 422. Values outside fixed enums also return HTTP 422. Invalid dictionary labels often return zero matches without an error, so verify copied labels before concluding that no creators match.\n\n### Pagination\nUse page_num from 1 to 250 and page_size from 1 to 20. Keep page_size at 20: the upstream removes unavailable or non-cooperating creators from each page, so a smaller size may leave zero rows. Page 251 and later return an empty array. Change only page_num between pages and keep all filters and sorting identical. The returned total is always 5000: it is the paging cap, not the actual match count.\n\n### Return and response access\nThe raw upstream envelope is in response.data; its payload is one level deeper at response.data.data. The payload contains kols[] (matched creators), total (paging cap, always 5000), trackId, and highlightWords. Each kols item includes identity fields userId, name, redId, headPhoto, location, and gender; tags contentTags, featureTags, personalTags, and tradeType; metrics fansNum, clickMidNum, interMidNum, fans30GrowthRate, and kliveCnt30d; and commercial fields picturePrice, videoPrice, lowerPrice, estimatePictureCpm, and cooperateState. Inspect these fields before making additional detail calls. Misspelled request field names return HTTP 422.\n\nAPI references: `get_blogger_filter_options` = `POST /tikhub/xiaohongshu/pgy/get_blogger_filter_options` (operationId: `post_tikhub_xiaohongshu_pgy_get_blogger_filter_options`); `get_blogger_similar` = `POST /tikhub/xiaohongshu/pgy/get_blogger_similar` (operationId: `post_tikhub_xiaohongshu_pgy_get_blogger_similar`).\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_xiaohongshu_pgy_get_blogger_list", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return and response access\nThe raw upstream envelope is in response.data; its payload is one level deeper at response.data.data. The payload contains kols[] (matched creators), total (paging cap, always 5000), trackId, and highlightWords. Each kols item includes identity fields userId, name, redId, headPhoto, location, and gender; tags contentTags, featureTags, personalTags, and tradeType; metrics fansNum, clickMidNum, interMidNum, fans30GrowthRate, and kliveCnt30d; and commercial fields picturePrice, videoPrice, lowerPrice, estimatePictureCpm, and cooperateState. Inspect these fields before making additional detail calls. Misspelled request field names return HTTP 422.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "xiaohongshu get_blogger_list", "tags": [ "tikhub.xiaohongshu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "8f4b42b5b03a" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/xiaohongshu/pgy/get_blogger_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_xiaohongshu_pgy_get_blogger_list", "method": "POST", "path": "/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_list" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "page_num": { "type": "integer", "maximum": 250.0, "minimum": 1.0, "title": "Page Num", "description": "Page, 1-250", "default": 1, "example": 1 }, "page_size": { "type": "integer", "maximum": 20.0, "minimum": 1.0, "title": "Page Size", "description": "Page size, 1-20 (web fixed at 20; recommended: keep at 20)", "default": 20, "example": 20 }, "keyword": { "type": "string", "maxLength": 50, "title": "Keyword", "description": "Search keyword; leave empty to filter without a text search.", "default": "", "example": "Coffee" }, "search_type": { "type": "integer", "enum": [ 0, 1 ], "title": "Search Type", "description": "1=search by note keyword (default); 0=search by creator nickname.", "default": 1, "example": 1 }, "column": { "type": "string", "enum": [ "comprehensiverank", "fansCount", "price", "clickNum", "mEngagementNum", "accumCommonImpMedinNum30d", "accumPicCommonImpMedinNum30d", "accumVideoCommonImpMedinNum30d", "pictureClickMidNum", "videoClickMidNum", "pictureInterMidNum", "videoInterMidNum", "thousandLikePercent30", "pictureThousandLikePercent30", "videoThousandLikePercent30", "hundredLikePercent30", "pictureHundredLikePercent30", "videoHundredLikePercent30", "videoFinishRate", "accumCoopImpMedinNum30d", "readMidCoop30", "interMidCoop30", "mCpuvNum30d", "picturePrice", "videoPrice", "pictureReadCost", "videoReadCost", "inviteReply48hNumRatio", "fans30GrowthRate", "fansActiveIn28dLv", "fansEngageNum30dLv", "kliveCnt30d", "avgLiveViewerNum", "avgAgmv90d" ], "title": "Column", "description": "Sort field; use one of the 34 enum keys in this schema. Defaults to comprehensiverank.", "default": "comprehensiverank", "example": "comprehensiverank" }, "sort": { "type": "string", "enum": [ "desc", "asc" ], "title": "Sort", "description": "Sort direction: desc (default) or asc.", "default": "desc", "example": "desc" }, "brand_user_id": { "title": "Brand User Id", "description": "Optional advertiser ID; enables personalized recommendations and prior-cooperation markers.", "example": "5dcfa5370000000001006030", "type": [ "string", "null" ] }, "similar_user_id": { "title": "Similar User Id", "description": "Creator userId for similar-creator search. Supports all other filters, unlike /tikhub/xiaohongshu/pgy/get_blogger_similar.\n\nAPI references: `get_blogger_similar` = `POST /tikhub/xiaohongshu/pgy/get_blogger_similar` (operationId: `post_tikhub_xiaohongshu_pgy_get_blogger_similar`).", "example": "5c668b3e0000000012021605", "type": [ "string", "null" ] }, "similar_word": { "title": "Similar Word", "description": "Nickname echo for similar_user_id; does not affect results", "type": [ "string", "null" ], "maxLength": 64 }, "goal": { "description": "Cooperation goal filters", "anyOf": [ { "description": "Cooperation goal filters", "allOf": [ { "properties": { "market_target": { "title": "Market Target", "description": "Marketing objective: on the web UI this is a three-level selector (objective -> metric -> measurement method); pass the final leaf code: `estimateAllCpm` Awareness/Impression Performance/Cost, `mAccumImpNum` Awareness/Impression Performance/Scale, `readCost` Awareness/Read Performance/Cost, `mValidRawReadFeedNum` Awareness/Read Performance/Scale, `estimateEngageCost` Consideration/Engagement Performance/Cost, `mEngagementNum90d` Consideration/Engagement Performance/Scale, `estimateCpuv` Conversion/Overflow Store-Visit Performance/Cost, `mCpuvNum` Conversion/Overflow Store-Visit Performance/Scale", "example": "mAccumImpNum", "type": [ "string", "null" ], "enum": [ "estimateAllCpm", "mAccumImpNum", "readCost", "mValidRawReadFeedNum", "estimateEngageCost", "mEngagementNum90d", "estimateCpuv", "mCpuvNum", null ] } }, "additionalProperties": false, "type": "object", "title": "GoalFilter", "description": "Cooperation goal: match bloggers by marketing objective (Exposure / Seeding / Conversion).\n\nTo filter bloggers by audience segment, use `BloggerAttrFilter.audience20` (top-20 audiences)." } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "blogger": { "description": "Blogger attribute filters", "anyOf": [ { "description": "Blogger attribute filters", "allOf": [ { "properties": { "content_tag": { "title": "Content Tag", "description": "Creator categories from the contentTags dictionary. Copy the original category names verbatim; level-1 and level-2 names can be mixed and are combined with OR. Use a level-1 name to select the whole category; expanding all its children can miss creators tagged only at the parent level. Omit this field for unrestricted categories. Invalid names silently return zero results. This taxonomy differs from coop.industry.", "example": [ "美妆", "面部保养", "面部清洁" ], "items": { "type": "string", "maxLength": 64 }, "type": [ "array", "null" ], "maxItems": 30 }, "personal_tags": { "title": "Personal Tags", "description": "Creator persona from personalTagsV2 in /tikhub/xiaohongshu/pgy/get_blogger_filter_options. Copy tagName verbatim at any of the three levels (identity, group, leaf). Levels can be mixed and values are combined with OR; select a group by its name without enumerating every leaf.\n\nAPI references: `get_blogger_filter_options` = `POST /tikhub/xiaohongshu/pgy/get_blogger_filter_options` (operationId: `post_tikhub_xiaohongshu_pgy_get_blogger_filter_options`).", "example": [ "妈妈" ], "items": { "type": "string", "maxLength": 64 }, "type": [ "array", "null" ], "maxItems": 30 }, "feature_tags": { "title": "Feature Tags", "description": "Specialty content from featureTags in /tikhub/xiaohongshu/pgy/get_blogger_filter_options. Copy the original label verbatim; level-1 and level-2 names can be mixed and are combined with OR. A level-1 name selects the whole group.\n\nAPI references: `get_blogger_filter_options` = `POST /tikhub/xiaohongshu/pgy/get_blogger_filter_options` (operationId: `post_tikhub_xiaohongshu_pgy_get_blogger_filter_options`).", "example": [ "vlog" ], "items": { "type": "string", "maxLength": 64 }, "type": [ "array", "null" ], "maxItems": 30 }, "content_theme": { "title": "Content Theme", "description": "Content theme from contentTheme in /tikhub/xiaohongshu/pgy/get_blogger_filter_options. Copy the original level-1 label verbatim. A sub-item label or numeric ID returns no results.\n\nAPI references: `get_blogger_filter_options` = `POST /tikhub/xiaohongshu/pgy/get_blogger_filter_options` (operationId: `post_tikhub_xiaohongshu_pgy_get_blogger_filter_options`).", "example": [ "汽车特色" ], "items": { "type": "string", "maxLength": 64 }, "type": [ "array", "null" ], "maxItems": 30 }, "audience20": { "title": "Audience20", "description": "Audience segments from audience20 (19 level-1 and 121 level-2 entries). Copy a level-1 name verbatim, or format a level-2 value as \" -\" with the parent name repeated. A bare level-2 label silently returns zero results. Mix levels in one array; values are combined with OR.", "example": [ "自由畅行", "自在户外 自在户外-挑战极限者" ], "items": { "type": "string", "maxLength": 64 }, "type": [ "array", "null" ], "maxItems": 30 }, "industry_crowd": { "title": "Industry Crowd", "description": "Industry-specific audience profile: use the **deepest leaf value** from automotiveIndustryTag in `/tikhub/xiaohongshu/pgy/get_blogger_filter_options` (numeric string ID, e.g. 15795914; 1,600+ available). Using a label or intermediate-level ID returns no results.\n\nAPI references: `get_blogger_filter_options` = `POST /tikhub/xiaohongshu/pgy/get_blogger_filter_options` (operationId: `post_tikhub_xiaohongshu_pgy_get_blogger_filter_options`).", "example": [ "15795914" ], "items": { "type": "string", "maxLength": 64 }, "type": [ "array", "null" ], "maxItems": 30 }, "consumer_behavior": { "title": "Consumer Behavior", "description": "Estimated consumer behavior from the five-level consumerBehavior dictionary. Copy the full space-separated path including the root; the path may stop at any depth. A bare leaf can silently disable the filter and return unfiltered results. Compare totals with and without this filter to verify it applied. A null dictionary value means this feature is unavailable to the account.", "example": [ "内容行为预估 汽车" ], "items": { "type": "string", "maxLength": 64 }, "type": [ "array", "null" ], "maxItems": 30 }, "note_scene": { "title": "Note Scene", "description": "Note category from contentScenes. Copy the full space-separated path including the root; a path can stop at any depth. Using only the last segment returns zero results.", "example": [ "汽车 理性决策 选车攻略 政策" ], "items": { "type": "string", "maxLength": 64 }, "type": [ "array", "null" ], "maxItems": 30 }, "gender": { "title": "Gender", "description": "Gender. Use the literal enum values: \"男\" means male and \"女\" means female. The Chinese strings are required wire values.", "example": "女", "type": [ "string", "null" ], "enum": [ "男", "女", null ] }, "location": { "title": "Location", "description": "Creator locations from areas in /tikhub/xiaohongshu/pgy/get_blogger_filter_options. Copy the original place names verbatim, including Chinese labels. Province, city, and district names can be mixed with OR. A full space-separated path is also accepted and normalized automatically.\n\nAPI references: `get_blogger_filter_options` = `POST /tikhub/xiaohongshu/pgy/get_blogger_filter_options` (operationId: `post_tikhub_xiaohongshu_pgy_get_blogger_filter_options`).", "example": [ "上海" ], "items": { "type": "string", "maxLength": 64 }, "type": [ "array", "null" ], "maxItems": 30 }, "signed": { "title": "Signed", "description": "Contract status: -1=no filter, 0=individual creator, 1=agency-signed creator", "example": 0, "type": [ "integer", "null" ], "enum": [ -1, 0, 1, null ] } }, "additionalProperties": false, "type": "object", "title": "BloggerAttrFilter", "description": "Creator attributes: categories, personas, specialty content, audience profiles, gender, location, and contract status. Fetch tree-style values from /tikhub/xiaohongshu/pgy/get_blogger_filter_options and copy their original labels verbatim. Each property explains which level or path format to use.\n\nAPI references: `get_blogger_filter_options` = `POST /tikhub/xiaohongshu/pgy/get_blogger_filter_options` (operationId: `post_tikhub_xiaohongshu_pgy_get_blogger_filter_options`)." } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "fans": { "description": "Fans profile filters", "anyOf": [ { "description": "Fans profile filters", "allOf": [ { "properties": { "count": { "description": "Follower count range", "anyOf": [ { "description": "Follower count range", "allOf": [ { "properties": { "min": { "title": "Min", "description": "Minimum value (inclusive)", "example": 10000, "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 }, "max": { "title": "Max", "description": "Maximum value (inclusive); omit for no upper limit", "example": 50000, "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 } }, "additionalProperties": false, "type": "object", "title": "RangeFilter", "description": "Numeric range corresponding to the custom input box in the web filter.\n\n- Either bound may be omitted: omitting `min` defaults to 0, omitting `max` means no upper limit\n- At least one bound must be provided, otherwise 422" } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "age": { "title": "Age", "description": "Audience age distribution: 0=no filter, 1=under 18, 2=18-24, 3=25-34, 4=35-44, 5=over 44 (high proportion)", "example": 3, "type": [ "integer", "null" ], "enum": [ 0, 1, 2, 3, 4, 5, null ] }, "gender": { "title": "Gender", "description": "Audience gender: 0=no filter, 1=predominantly male, 2=predominantly female", "example": 2, "type": [ "integer", "null" ], "enum": [ 0, 1, 2, null ] }, "marital_status": { "title": "Marital Status", "description": "Relationship status: -1=no filter, 0=single/unmarried, 1=married", "type": [ "integer", "null" ], "enum": [ -1, 0, 1, null ] }, "consumption_level": { "title": "Consumption Level", "description": "Consumption level: -1=no filter, 0=low, 1=medium, 2=high", "type": [ "integer", "null" ], "enum": [ -1, 0, 1, 2, null ] }, "child_age": { "title": "Child Age", "description": "Parenting stage: 0=trying to conceive, 2=0-6 months, 3=7-12 months, 4=1-3 years, 5=4-6 years, 6=7-12 years, 7=early pregnancy, 8=late pregnancy", "items": { "type": "integer", "enum": [ 0, 2, 3, 4, 5, 6, 7, 8 ] }, "type": [ "array", "null" ], "maxItems": 30 }, "device_price": { "title": "Device Price", "description": "Phone price tier, e.g. 3000-3999 / 8000+", "example": [ "3000-3999" ], "items": { "type": "string", "enum": [ "0-999", "1000-1999", "2000-2999", "3000-3999", "4000-4999", "5000-5999", "6000-6999", "7000-7999", "8000+" ] }, "type": [ "array", "null" ], "maxItems": 30 }, "device_brand": { "title": "Device Brand", "description": "Audience phone brands. Copy the literal enum values in items.enum, including Chinese brand names; do not translate them.", "example": [ "苹果" ], "items": { "type": "string", "enum": [ "苹果", "华为", "OPPO", "VIVO", "荣耀", "小米", "一加", "魅族", "中兴", "联想" ] }, "type": [ "array", "null" ], "maxItems": 30 }, "location": { "title": "Location", "description": "Audience locations from fansAreas in /tikhub/xiaohongshu/pgy/get_blogger_filter_options. Copy the original Chinese place names or full space-separated paths verbatim; the tree ends at city level and has no districts. Plain names are normalized into full paths automatically.\n\nAPI references: `get_blogger_filter_options` = `POST /tikhub/xiaohongshu/pgy/get_blogger_filter_options` (operationId: `post_tikhub_xiaohongshu_pgy_get_blogger_filter_options`).", "example": [ "上海" ], "items": { "type": "string", "maxLength": 64 }, "type": [ "array", "null" ], "maxItems": 30 } }, "additionalProperties": false, "type": "object", "title": "FansFilter", "description": "Audience profile — the \"Audience Profile\" section of the web page (follower count / age / gender / region / relationship status / spending / parenting & baby / mobile device)." } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "note": { "description": "Organic note metric filters", "anyOf": [ { "description": "Organic note metric filters", "allOf": [ { "properties": { "imp_median": { "description": "Median impressions", "anyOf": [ { "description": "Median impressions", "allOf": [ { "properties": { "min": { "title": "Min", "description": "Minimum value (inclusive)", "example": 10000, "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 }, "max": { "title": "Max", "description": "Maximum value (inclusive); omit for no upper limit", "example": 50000, "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 } }, "additionalProperties": false, "type": "object", "title": "RangeFilter", "description": "Numeric range corresponding to the custom input box in the web filter.\n\n- Either bound may be omitted: omitting `min` defaults to 0, omitting `max` means no upper limit\n- At least one bound must be provided, otherwise 422" } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "read_median": { "description": "Median reads", "anyOf": [ { "description": "Median reads", "allOf": [ { "properties": { "min": { "title": "Min", "description": "Minimum value (inclusive)", "example": 10000, "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 }, "max": { "title": "Max", "description": "Maximum value (inclusive); omit for no upper limit", "example": 50000, "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 } }, "additionalProperties": false, "type": "object", "title": "RangeFilter", "description": "Numeric range corresponding to the custom input box in the web filter.\n\n- Either bound may be omitted: omitting `min` defaults to 0, omitting `max` means no upper limit\n- At least one bound must be provided, otherwise 422" } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "inter_median": { "description": "Median engagement count", "anyOf": [ { "description": "Median engagement count", "allOf": [ { "properties": { "min": { "title": "Min", "description": "Minimum value (inclusive)", "example": 10000, "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 }, "max": { "title": "Max", "description": "Maximum value (inclusive); omit for no upper limit", "example": 50000, "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 } }, "additionalProperties": false, "type": "object", "title": "RangeFilter", "description": "Numeric range corresponding to the custom input box in the web filter.\n\n- Either bound may be omitted: omitting `min` defaults to 0, omitting `max` means no upper limit\n- At least one bound must be provided, otherwise 422" } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "thousand_like_percent": { "description": "1,000-like note ratio: fill 0-100 percent points (20 means 20%, not 0.2)", "anyOf": [ { "description": "1,000-like note ratio: fill 0-100 percent points (20 means 20%, not 0.2)", "allOf": [ { "properties": { "min": { "title": "Min", "description": "Minimum value (inclusive), percentile 0-100", "example": 20, "type": [ "number", "null" ], "maximum": 100.0, "minimum": 0.0 }, "max": { "title": "Max", "description": "Maximum value (inclusive), percentile 0-100", "example": 80, "type": [ "number", "null" ], "maximum": 100.0, "minimum": 0.0 } }, "additionalProperties": false, "type": "object", "title": "PercentRange", "description": "Percentage range: enter a value between 0 and 100 as a percentile, e.g. `40` means 40% (**not 0.4**).\n\nThis convention follows the PGY web interface: the tier for notes-per-thousand-likes is written as `{\"40% and above\": [40, null]}` or `{\"below 10%\": [null, 10]}` — the value sent upstream is simply 40 or 10.\n\n**What is and is not validated — stated clearly to avoid confusion**:\n* Caught: values with the wrong order of magnitude — entering 200 or 9500 (as if using parts-per-ten-thousand or raw counts) will return a 422 error, whereas the generic RangeFilter allows up to 1e12 and previously passed such values through.\n* **Not caught: values that are too small** — entering 0.4 is still valid because 0.4% is a legitimate value; the type system cannot distinguish \"meant 40% but wrote 0.4\" from \"genuinely filtering for 0.4%\". This ambiguity can only be resolved through field documentation." } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "note_type": { "title": "Note Type", "description": "Note type: 0=no filter, 1=primarily image+text notes, 2=primarily video notes", "example": 2, "type": [ "integer", "null" ], "enum": [ 0, 1, 2, null ] } }, "additionalProperties": false, "type": "object", "title": "NoteFilter", "description": "Organic note data — the 'Daily Notes' section on the web page (organic traffic performance over the last 30 days)." } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "coop": { "description": "Sponsored note metric filters", "anyOf": [ { "description": "Sponsored note metric filters", "allOf": [ { "properties": { "pic_price": { "description": "Cooperation quote — fixed price for image+text notes (RMB)", "anyOf": [ { "description": "Cooperation quote — fixed price for image+text notes (RMB)", "allOf": [ { "properties": { "min": { "title": "Min", "description": "Minimum value (inclusive)", "example": 10000, "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 }, "max": { "title": "Max", "description": "Maximum value (inclusive); omit for no upper limit", "example": 50000, "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 } }, "additionalProperties": false, "type": "object", "title": "RangeFilter", "description": "Numeric range corresponding to the custom input box in the web filter.\n\n- Either bound may be omitted: omitting `min` defaults to 0, omitting `max` means no upper limit\n- At least one bound must be provided, otherwise 422" } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "video_price": { "description": "Cooperation quote — fixed price for video notes (RMB)", "anyOf": [ { "description": "Cooperation quote — fixed price for video notes (RMB)", "allOf": [ { "properties": { "min": { "title": "Min", "description": "Minimum value (inclusive)", "example": 10000, "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 }, "max": { "title": "Max", "description": "Maximum value (inclusive); omit for no upper limit", "example": 50000, "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 } }, "additionalProperties": false, "type": "object", "title": "RangeFilter", "description": "Numeric range corresponding to the custom input box in the web filter.\n\n- Either bound may be omitted: omitting `min` defaults to 0, omitting `max` means no upper limit\n- At least one bound must be provided, otherwise 422" } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "order_count": { "description": "Open orders (accepted but not yet completed), NOT lifetime collaboration count. This reflects current in-progress orders; do not use this field to find experienced creators.", "anyOf": [ { "description": "Open orders (accepted but not yet completed), NOT lifetime collaboration count. This reflects current in-progress orders; do not use this field to find experienced creators.", "allOf": [ { "properties": { "min": { "title": "Min", "description": "Minimum value (inclusive)", "example": 10000, "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 }, "max": { "title": "Max", "description": "Maximum value (inclusive); omit for no upper limit", "example": 50000, "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 } }, "additionalProperties": false, "type": "object", "title": "RangeFilter", "description": "Numeric range corresponding to the custom input box in the web filter.\n\n- Either bound may be omitted: omitting `min` defaults to 0, omitting `max` means no upper limit\n- At least one bound must be provided, otherwise 422" } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "reply_48h_ratio": { "description": "Cooperation credit — 48h invitation reply rate: fill 0-100 percent points (80 means 80%)", "anyOf": [ { "description": "Cooperation credit — 48h invitation reply rate: fill 0-100 percent points (80 means 80%)", "allOf": [ { "properties": { "min": { "title": "Min", "description": "Minimum value (inclusive), percentile 0-100", "example": 20, "type": [ "number", "null" ], "maximum": 100.0, "minimum": 0.0 }, "max": { "title": "Max", "description": "Maximum value (inclusive), percentile 0-100", "example": 80, "type": [ "number", "null" ], "maximum": 100.0, "minimum": 0.0 } }, "additionalProperties": false, "type": "object", "title": "PercentRange", "description": "Percentage range: enter a value between 0 and 100 as a percentile, e.g. `40` means 40% (**not 0.4**).\n\nThis convention follows the PGY web interface: the tier for notes-per-thousand-likes is written as `{\"40% and above\": [40, null]}` or `{\"below 10%\": [null, 10]}` — the value sent upstream is simply 40 or 10.\n\n**What is and is not validated — stated clearly to avoid confusion**:\n* Caught: values with the wrong order of magnitude — entering 200 or 9500 (as if using parts-per-ten-thousand or raw counts) will return a 422 error, whereas the generic RangeFilter allows up to 1e12 and previously passed such values through.\n* **Not caught: values that are too small** — entering 0.4 is still valid because 0.4% is a legitimate value; the type system cannot distinguish \"meant 40% but wrote 0.4\" from \"genuinely filtering for 0.4%\". This ambiguity can only be resolved through field documentation." } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "industry": { "title": "Industry", "description": "Recent collaboration industries. Use one of the literal enum values in this schema, including required Chinese labels.", "example": "美妆个护", "type": [ "string", "null" ], "enum": [ "不限", "美妆个护", "食品饮料", "母婴", "3c及电器", "日用百货", "服装配饰", "互联网", "生活服务", "家居建材", "汽车", null ] }, "brand_ids": { "title": "Brand Ids", "description": "Recent collaboration brands: list of brand userIds", "items": { "type": "string", "maxLength": 64 }, "type": [ "array", "null" ], "maxItems": 20 }, "exclude_brands": { "title": "Exclude Brands", "description": "Used with brand_ids: true=exclude bloggers who have cooperated with these brands", "type": [ "boolean", "null" ] }, "imp_median": { "description": "Reach scale — median impressions (collaboration notes)", "anyOf": [ { "description": "Reach scale — median impressions (collaboration notes)", "allOf": [ { "properties": { "min": { "title": "Min", "description": "Minimum value (inclusive)", "example": 10000, "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 }, "max": { "title": "Max", "description": "Maximum value (inclusive); omit for no upper limit", "example": 50000, "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 } }, "additionalProperties": false, "type": "object", "title": "RangeFilter", "description": "Numeric range corresponding to the custom input box in the web filter.\n\n- Either bound may be omitted: omitting `min` defaults to 0, omitting `max` means no upper limit\n- At least one bound must be provided, otherwise 422" } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "read_median": { "description": "Reach scale — median reads (collaboration notes)", "anyOf": [ { "description": "Reach scale — median reads (collaboration notes)", "allOf": [ { "properties": { "min": { "title": "Min", "description": "Minimum value (inclusive)", "example": 10000, "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 }, "max": { "title": "Max", "description": "Maximum value (inclusive); omit for no upper limit", "example": 50000, "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 } }, "additionalProperties": false, "type": "object", "title": "RangeFilter", "description": "Numeric range corresponding to the custom input box in the web filter.\n\n- Either bound may be omitted: omitting `min` defaults to 0, omitting `max` means no upper limit\n- At least one bound must be provided, otherwise 422" } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "inter_median": { "description": "Reach scale — median engagement count (collaboration notes)", "anyOf": [ { "description": "Reach scale — median engagement count (collaboration notes)", "allOf": [ { "properties": { "min": { "title": "Min", "description": "Minimum value (inclusive)", "example": 10000, "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 }, "max": { "title": "Max", "description": "Maximum value (inclusive); omit for no upper limit", "example": 50000, "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 } }, "additionalProperties": false, "type": "object", "title": "RangeFilter", "description": "Numeric range corresponding to the custom input box in the web filter.\n\n- Either bound may be omitted: omitting `min` defaults to 0, omitting `max` means no upper limit\n- At least one bound must be provided, otherwise 422" } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "cpuv": { "description": "Reach scale — median store-visit UV count (not cost): median store-visit UV count for cross-domain collaboration notes in the last 30 days. **This is a visit count, not a monetary amount** (web tiers: 500-1000 / 1000-2000 / 2000-5000 / 5000-10000 / 10000+). To filter by cost per store visit, use estimate_cpuv instead.", "anyOf": [ { "description": "Reach scale — median store-visit UV count (not cost): median store-visit UV count for cross-domain collaboration notes in the last 30 days. **This is a visit count, not a monetary amount** (web tiers: 500-1000 / 1000-2000 / 2000-5000 / 5000-10000 / 10000+). To filter by cost per store visit, use estimate_cpuv instead.", "allOf": [ { "properties": { "min": { "title": "Min", "description": "Minimum value (inclusive)", "example": 10000, "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 }, "max": { "title": "Max", "description": "Maximum value (inclusive); omit for no upper limit", "example": 50000, "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 } }, "additionalProperties": false, "type": "object", "title": "RangeFilter", "description": "Numeric range corresponding to the custom input box in the web filter.\n\n- Either bound may be omitted: omitting `min` defaults to 0, omitting `max` means no upper limit\n- At least one bound must be provided, otherwise 422" } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "pic_cpm": { "description": "Estimated CPM — image+text notes", "anyOf": [ { "description": "Estimated CPM — image+text notes", "allOf": [ { "properties": { "min": { "title": "Min", "description": "Minimum value (inclusive)", "example": 10000, "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 }, "max": { "title": "Max", "description": "Maximum value (inclusive); omit for no upper limit", "example": 50000, "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 } }, "additionalProperties": false, "type": "object", "title": "RangeFilter", "description": "Numeric range corresponding to the custom input box in the web filter.\n\n- Either bound may be omitted: omitting `min` defaults to 0, omitting `max` means no upper limit\n- At least one bound must be provided, otherwise 422" } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "video_cpm": { "description": "Estimated CPM — video notes", "anyOf": [ { "description": "Estimated CPM — video notes", "allOf": [ { "properties": { "min": { "title": "Min", "description": "Minimum value (inclusive)", "example": 10000, "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 }, "max": { "title": "Max", "description": "Maximum value (inclusive); omit for no upper limit", "example": 50000, "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 } }, "additionalProperties": false, "type": "object", "title": "RangeFilter", "description": "Numeric range corresponding to the custom input box in the web filter.\n\n- Either bound may be omitted: omitting `min` defaults to 0, omitting `max` means no upper limit\n- At least one bound must be provided, otherwise 422" } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "pic_read_price": { "description": "Estimated cost per read — image+text notes", "anyOf": [ { "description": "Estimated cost per read — image+text notes", "allOf": [ { "properties": { "min": { "title": "Min", "description": "Minimum value (inclusive)", "example": 10000, "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 }, "max": { "title": "Max", "description": "Maximum value (inclusive); omit for no upper limit", "example": 50000, "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 } }, "additionalProperties": false, "type": "object", "title": "RangeFilter", "description": "Numeric range corresponding to the custom input box in the web filter.\n\n- Either bound may be omitted: omitting `min` defaults to 0, omitting `max` means no upper limit\n- At least one bound must be provided, otherwise 422" } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "video_read_price": { "description": "Estimated cost per read — video notes", "anyOf": [ { "description": "Estimated cost per read — video notes", "allOf": [ { "properties": { "min": { "title": "Min", "description": "Minimum value (inclusive)", "example": 10000, "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 }, "max": { "title": "Max", "description": "Maximum value (inclusive); omit for no upper limit", "example": 50000, "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 } }, "additionalProperties": false, "type": "object", "title": "RangeFilter", "description": "Numeric range corresponding to the custom input box in the web filter.\n\n- Either bound may be omitted: omitting `min` defaults to 0, omitting `max` means no upper limit\n- At least one bound must be provided, otherwise 422" } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "pic_engage_cost": { "description": "Estimated cost per engagement — image+text notes", "anyOf": [ { "description": "Estimated cost per engagement — image+text notes", "allOf": [ { "properties": { "min": { "title": "Min", "description": "Minimum value (inclusive)", "example": 10000, "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 }, "max": { "title": "Max", "description": "Maximum value (inclusive); omit for no upper limit", "example": 50000, "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 } }, "additionalProperties": false, "type": "object", "title": "RangeFilter", "description": "Numeric range corresponding to the custom input box in the web filter.\n\n- Either bound may be omitted: omitting `min` defaults to 0, omitting `max` means no upper limit\n- At least one bound must be provided, otherwise 422" } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "video_engage_cost": { "description": "Estimated cost per engagement — video notes", "anyOf": [ { "description": "Estimated cost per engagement — video notes", "allOf": [ { "properties": { "min": { "title": "Min", "description": "Minimum value (inclusive)", "example": 10000, "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 }, "max": { "title": "Max", "description": "Maximum value (inclusive); omit for no upper limit", "example": 50000, "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 } }, "additionalProperties": false, "type": "object", "title": "RangeFilter", "description": "Numeric range corresponding to the custom input box in the web filter.\n\n- Either bound may be omitted: omitting `min` defaults to 0, omitting `max` means no upper limit\n- At least one bound must be provided, otherwise 422" } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "estimate_cpuv": { "description": "Overflow store-visit cost per visit", "anyOf": [ { "description": "Overflow store-visit cost per visit", "allOf": [ { "properties": { "min": { "title": "Min", "description": "Minimum value (inclusive)", "example": 10000, "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 }, "max": { "title": "Max", "description": "Maximum value (inclusive); omit for no upper limit", "example": 50000, "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 } }, "additionalProperties": false, "type": "object", "title": "RangeFilter", "description": "Numeric range corresponding to the custom input box in the web filter.\n\n- Either bound may be omitted: omitting `min` defaults to 0, omitting `max` means no upper limit\n- At least one bound must be provided, otherwise 422" } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] } }, "additionalProperties": false, "type": "object", "title": "CoopFilter", "description": "Sponsored notes — the \"Sponsored Notes\" section on the web page (cooperation performance + data performance)." } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "live": { "description": "Live metric filters", "anyOf": [ { "description": "Live metric filters", "allOf": [ { "properties": { "live_count": { "description": "Number of live streams in the last 30 days", "anyOf": [ { "description": "Number of live streams in the last 30 days", "allOf": [ { "properties": { "min": { "title": "Min", "description": "Minimum value (inclusive)", "example": 10000, "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 }, "max": { "title": "Max", "description": "Maximum value (inclusive); omit for no upper limit", "example": 50000, "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 } }, "additionalProperties": false, "type": "object", "title": "RangeFilter", "description": "Numeric range corresponding to the custom input box in the web filter.\n\n- Either bound may be omitted: omitting `min` defaults to 0, omitting `max` means no upper limit\n- At least one bound must be provided, otherwise 422" } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "avg_viewer": { "description": "Average viewers per live stream over the last 90 days (live_count uses a 30-day window instead).", "anyOf": [ { "description": "Average viewers per live stream over the last 90 days (live_count uses a 30-day window instead).", "allOf": [ { "properties": { "min": { "title": "Min", "description": "Minimum value (inclusive)", "example": 10000, "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 }, "max": { "title": "Max", "description": "Maximum value (inclusive); omit for no upper limit", "example": 50000, "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 } }, "additionalProperties": false, "type": "object", "title": "RangeFilter", "description": "Numeric range corresponding to the custom input box in the web filter.\n\n- Either bound may be omitted: omitting `min` defaults to 0, omitting `max` means no upper limit\n- At least one bound must be provided, otherwise 422" } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "avg_gmv": { "description": "Average GMV per live stream over the last 90 days (live_count uses a 30-day window instead).", "anyOf": [ { "description": "Average GMV per live stream over the last 90 days (live_count uses a 30-day window instead).", "allOf": [ { "properties": { "min": { "title": "Min", "description": "Minimum value (inclusive)", "example": 10000, "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 }, "max": { "title": "Max", "description": "Maximum value (inclusive); omit for no upper limit", "example": 50000, "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 } }, "additionalProperties": false, "type": "object", "title": "RangeFilter", "description": "Numeric range corresponding to the custom input box in the web filter.\n\n- Either bound may be omitted: omitting `min` defaults to 0, omitting `max` means no upper limit\n- At least one bound must be provided, otherwise 422" } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] } }, "additionalProperties": false, "type": "object", "title": "LiveFilter", "description": "Live data — the \"Live Data\" section of the web page." } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "flags": { "description": "Boolean flag filters", "anyOf": [ { "description": "Boolean flag filters", "allOf": [ { "properties": { "is_star": { "title": "Is Star", "description": "Celebrity", "type": [ "boolean", "null" ] }, "new_high_quality": { "title": "New High Quality", "description": "Rising creator", "type": [ "boolean", "null" ] }, "high_quality": { "title": "High Quality", "description": "Quality creator", "type": [ "boolean", "null" ] }, "note_and_live": { "title": "Note And Live", "description": "Both notes and live streams available for collaboration", "type": [ "boolean", "null" ] }, "filter_intention": { "title": "Filter Intention", "description": "Intended industry match", "type": [ "boolean", "null" ] }, "activity_codes": { "title": "Activity Codes", "description": "Trending activity: use the `code` value for each item in the activities list from `/tikhub/xiaohongshu/pgy/get_blogger_filter_options`\n\nAPI references: `get_blogger_filter_options` = `POST /tikhub/xiaohongshu/pgy/get_blogger_filter_options` (operationId: `post_tikhub_xiaohongshu_pgy_get_blogger_filter_options`).", "items": { "type": "string", "maxLength": 64 }, "type": [ "array", "null" ], "maxItems": 30 }, "exclude_low_active": { "title": "Exclude Low Active", "description": "Exclude low-activity creators", "type": [ "boolean", "null" ] }, "exclude_fans_down": { "title": "Exclude Fans Down", "description": "Exclude creators with declining followers", "type": [ "boolean", "null" ] }, "exclude_cooperated": { "title": "Exclude Cooperated", "description": "Exclude previously collaborated creators", "type": [ "boolean", "null" ] }, "exclude_invited": { "title": "Exclude Invited", "description": "Exclude already-invited creators", "type": [ "boolean", "null" ] }, "industry_first": { "title": "Industry First", "description": "Industry-recommended creators — level-1 industry name (e.g. Beauty & Personal Care); the platform will recommend creators specializing in that industry", "example": "美妆个护", "type": [ "string", "null" ], "maxLength": 64 }, "industry_second": { "title": "Industry Second", "description": "Industry-recommended creators — level-2 industry name (used together with industry_first; values from taxonomy2Tags in industryTags in `/tikhub/xiaohongshu/pgy/get_blogger_filter_options`)\n\nAPI references: `get_blogger_filter_options` = `POST /tikhub/xiaohongshu/pgy/get_blogger_filter_options` (operationId: `post_tikhub_xiaohongshu_pgy_get_blogger_filter_options`).", "type": [ "string", "null" ], "maxLength": 64 } }, "additionalProperties": false, "type": "object", "title": "FlagFilter", "description": "Boolean flags — controls the \"Platform Recommendations\" (featured bloggers / trending campaigns) and \"Standard Exclusions\" (one-click exclude) sections on the web page." } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] } }, "additionalProperties": false, "type": "object", "title": "BloggerListReq" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:6af5575420f4661c4bd002356d8b2c43ab2f25573ed35d7107398c1103f2389a" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-xiaohongshu-pgy-get_blogger_list" } }, "/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_notes_rate": { "post": { "description": "Xiaohongshu (pgy). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Overall content performance of a blogger, for judging quality and consistency\n\n### Request Body Parameters\n- user_id: **required**, blogger user ID\n- business: note scope, 0=organic (default), 1=**sponsored**\n- note_type: 3=image-text+video (default), 1=image-text, 2=video\n **Warning**: differs from the upstream V1 note-list endpoint (not exposed in this specification), where 4=all and 3=sponsored\n- date_type: 1=last 30 days (default), 2=last 90 days\n- advertise_switch: 1=all traffic (default), 0=organic only\n\n### Return\n- Medians: impMedian / readMedian / interactionMedian\n- Rates: engagement rate, completion rate, 100-like / 1000-like note ratio\n- Percentile vs peers (e.g. impMedianBeyondRate)\n\n### Tip\n- Set business=1 and compare against business=0 to see how the blogger performs on sponsored content\n\n### Response shape (two layers)\n- `resp[\"data\"]` is PGY's raw envelope (with `code`/`msg`/`success`); the payload is one level deeper\n- Correct access: `data = resp[\"data\"][\"data\"]` — every field listed under \"Return\" lives here\n\n### Billing\n- HTTP 200 → **charged**, including \"no result\" (`data` is null, e.g. ID not found or filters matched\n nothing): the request did reach PGY, so retrying on empty data just burns quota\n- HTTP 400 → not charged (malformed params, or upstream unavailable/error)\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_xiaohongshu_pgy_get_blogger_notes_rate", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Medians: impMedian / readMedian / interactionMedian\n- Rates: engagement rate, completion rate, 100-like / 1000-like note ratio\n- Percentile vs peers (e.g. impMedianBeyondRate)\n\n### Response shape (two layers)\n- `resp[\"data\"]` is PGY's raw envelope (with `code`/`msg`/`success`); the payload is one level deeper\n- Correct access: `data = resp[\"data\"][\"data\"]` — every field listed under \"Return\" lives here", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "xiaohongshu get_blogger_notes_rate", "tags": [ "tikhub.xiaohongshu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "383d4b30f0ea" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/xiaohongshu/pgy/get_blogger_notes_rate", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_xiaohongshu_pgy_get_blogger_notes_rate", "method": "POST", "path": "/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_notes_rate" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "user_id": { "type": "string", "title": "User Id", "description": "Blogger user ID", "example": "5c668b3e0000000012021605" }, "business": { "type": "integer", "enum": [ 0, 1 ], "title": "Business", "description": "Note scope: 0=organic (default), 1=sponsored", "default": 0, "example": 0 }, "note_type": { "type": "integer", "enum": [ 1, 2, 3 ], "title": "Note Type", "description": "Note type: 3=image and video notes (default), 1=image notes, 2=video notes. The upstream V1 get_blogger_notes endpoint uses different values: 4=all, 3=sponsored. That endpoint is not exposed in this specification.", "default": 3, "example": 3 }, "date_type": { "type": "integer", "enum": [ 1, 2 ], "title": "Date Type", "description": "Date range: 1=last 30 days (default), 2=last 90 days", "default": 1, "example": 1 }, "advertise_switch": { "type": "integer", "enum": [ 0, 1 ], "title": "Advertise Switch", "description": "Traffic type: 1=All (including sponsored), 0=Organic only\n\nUsage: 1=all traffic (default), 0=organic only", "default": 1, "example": 1 } }, "additionalProperties": false, "type": "object", "required": [ "user_id" ], "title": "NotesRateReq" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:647893b1fb06c80b518209e24cd2dc0c1e945ff385431dcaee5dc20fde2ac9a4" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_notes_rate \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"user_id\": \"5c668b3e0000000012021605\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-xiaohongshu-pgy-get_blogger_notes_rate" } }, "/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_notes_v2": { "post": { "description": "Xiaohongshu (pgy). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Paginated note cases of a blogger (v2). A **separate endpoint** from `the upstream V1 note-list endpoint (not exposed in this specification)`:\n wider coverage (incl. cross-platform notes) and a different response shape\n- **Use this when `the upstream V1 note-list endpoint (not exposed in this specification)` returns an empty list**\n- The two endpoints differ in note_type values and return fields; do not mix them\n\n### Request Body Parameters\n- user_id: **required**, blogger user ID\n- page_number: page number from 1\n- page_size: **1-8** (fixed at 8 on the PGY web page, cannot be larger)\n- note_type: 0=all (default), 1=image-text, 2=video\n- order_type: 1=newest (default), 2=most read, 3=most engaged\n\n### Return\n- noteList[]: each item has noteInfo (noteId / title / imageUrl / notePublishTime /\n noteType / impNum / readNum / engageNum / favNum) + userInfo\n- total: total notes matching the filters\n\n### Paging\n- Change page_number only, keep other params identical; an empty array means no more data\n\n### Response shape (two layers)\n- `resp[\"data\"]` is PGY's raw envelope (with `code`/`msg`/`success`); the payload is one level deeper\n- Correct access: `data = resp[\"data\"][\"data\"]` — every field listed under \"Return\" lives here\n\n### Billing\n- HTTP 200 → **charged**, including \"no result\" (`data` is null, e.g. ID not found or filters matched\n nothing): the request did reach PGY, so retrying on empty data just burns quota\n- HTTP 400 → not charged (malformed params, or upstream unavailable/error)\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_xiaohongshu_pgy_get_blogger_notes_v2", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- noteList[]: each item has noteInfo (noteId / title / imageUrl / notePublishTime /\n noteType / impNum / readNum / engageNum / favNum) + userInfo\n- total: total notes matching the filters\n\n### Response shape (two layers)\n- `resp[\"data\"]` is PGY's raw envelope (with `code`/`msg`/`success`); the payload is one level deeper\n- Correct access: `data = resp[\"data\"][\"data\"]` — every field listed under \"Return\" lives here", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "xiaohongshu get_blogger_notes", "tags": [ "tikhub.xiaohongshu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a001f9aec52e" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/xiaohongshu/pgy/get_blogger_notes_v2", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_xiaohongshu_pgy_get_blogger_notes_v2", "method": "POST", "path": "/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_notes_v2" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "user_id": { "type": "string", "title": "User Id", "description": "Blogger user ID", "example": "5c668b3e0000000012021605" }, "page_number": { "type": "integer", "maximum": 1000.0, "minimum": 1.0, "title": "Page Number", "description": "Page number, from 1", "default": 1, "example": 1 }, "page_size": { "type": "integer", "maximum": 8.0, "minimum": 1.0, "title": "Page Size", "description": "Page size, 1-8 (fixed at 8 on PGY web)", "default": 8, "example": 8 }, "note_type": { "type": "integer", "enum": [ 0, 1, 2 ], "title": "Note Type", "description": "Note type: 0=All types (default), 1=Image & text, 2=Video\n\nUsage: 0=all (default), 1=image-text, 2=video", "default": 0, "example": 0 }, "order_type": { "type": "integer", "enum": [ 1, 2, 3 ], "title": "Order Type", "description": "Sort: 1=Latest (default), 2=Most read, 3=Most engaged\n\nUsage: 1=newest (default), 2=most read, 3=most engaged", "default": 1, "example": 1 } }, "additionalProperties": false, "type": "object", "required": [ "user_id" ], "title": "NotesV2Req" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:8145cbbca6a10f6d0329ba17942844662220ec347d039c1cf9bd07605dfe4618" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_notes_v2 \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"user_id\": \"5c668b3e0000000012021605\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-xiaohongshu-pgy-get_blogger_notes_v2" } }, "/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_similar": { "post": { "description": "Xiaohongshu (pgy). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Given one blogger, return similar bloggers (\"Similar Bloggers\" on the blogger page)\n- Typical use: pick one good benchmark blogger, then expand by similarity\n\n### Request Body Parameters\n- user_id: **required**, target blogger user ID\n- page_num: page number from 1\n- page_size: **1-4** (fixed at 4 on the PGY web page)\n\n### Return\n- Same shape as the note blogger square (kols[] + total), parsing code is reusable\n- Similar bloggers usually number from a few to a few dozen; total is the cap\n\n### Paging\n- Change page_num only; an empty array means no more data\n\n### Response shape (two layers)\n- `resp[\"data\"]` is PGY's raw envelope (with `code`/`msg`/`success`); the payload is one level deeper\n- Correct access: `data = resp[\"data\"][\"data\"]` — every field listed under \"Return\" lives here\n\n### Billing\n- HTTP 200 → **charged**, including \"no result\" (`data` is null, e.g. ID not found or filters matched\n nothing): the request did reach PGY, so retrying on empty data just burns quota\n- HTTP 400 → not charged (malformed params, or upstream unavailable/error)\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_xiaohongshu_pgy_get_blogger_similar", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Same shape as the note blogger square (kols[] + total), parsing code is reusable\n- Similar bloggers usually number from a few to a few dozen; total is the cap\n\n### Response shape (two layers)\n- `resp[\"data\"]` is PGY's raw envelope (with `code`/`msg`/`success`); the payload is one level deeper\n- Correct access: `data = resp[\"data\"][\"data\"]` — every field listed under \"Return\" lives here", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "xiaohongshu get_blogger_similar", "tags": [ "tikhub.xiaohongshu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "f45b0df27a13" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/xiaohongshu/pgy/get_blogger_similar", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_xiaohongshu_pgy_get_blogger_similar", "method": "POST", "path": "/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_similar" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "user_id": { "type": "string", "title": "User Id", "description": "Target blogger user ID", "example": "5c668b3e0000000012021605" }, "page_num": { "type": "integer", "maximum": 100.0, "minimum": 1.0, "title": "Page Num", "description": "Page", "default": 1, "example": 1 }, "page_size": { "type": "integer", "maximum": 4.0, "minimum": 1.0, "title": "Page Size", "description": "Page size, 1-4 (web fixed at 4)\n\nUsage: **1-4** (fixed at 4 on the PGY web page)", "default": 4, "example": 4 } }, "additionalProperties": false, "type": "object", "required": [ "user_id" ], "title": "SimilarReq" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:f0a4cff96cd42ef430095dac4a94c9f6beee679206fd10df5a20ef093b39ce8d" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_similar \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"user_id\": \"5c668b3e0000000012021605\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-xiaohongshu-pgy-get_blogger_similar" } }, "/apis/v1/tikhub/xiaohongshu/pgy/get_content_square": { "post": { "description": "Xiaohongshu (pgy). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Replica of PGY \"Learn Content → Inspiration → Content Square\": **no ID required**,\n directly answers \"what content is hot right now\"\n- Opposite direction from every other endpoint — this one is an entry point; take the\n blogger IDs from the returned notes and drill down with the blogger endpoints\n\n### 1. Full Parameter List\n| Param | Required | Default | Description |\n|---|---|---|---|\n| `biz_type` | ✅ | — | Leaderboard, see section 3 |\n| `page_num` | | `1` | Page, 1-100 |\n| `page_size` | | `34` | **1-34** (fixed at 34 on the web page) |\n| `search_word` | | `\"\"` | Keyword; empty = whole board. Comma-separated for batch search |\n| `order_by` | | per board | Sort field, see section 5; empty = board default |\n| `date_range` | | `7` | Window in days: `3` / `7` / `14` / `30` |\n| `sub_biz_type` | | `3` | **Board 8 only**, see section 6 |\n| `category` | | — | **Board 1 only**, see section 4 |\n| `industry` | | — | **Boards 2/3/4/5/6/7/8**, see section 4 |\n| `note_type` / `content_type` / `theme` | | — | See section 6 |\n| `author_type` / `placement` / `marketing_target` | | — | See section 6 |\n| `price` / `fans` | | — | **Board 4 only**, see section 6 |\n\nOmitted filters mean \"no limit\". **Do not send unused fields as empty strings or 0** —\nthey would be treated as a real filter.\n\n### 2. Paging\nChange `page_num` only and keep every other parameter identical.\n\n**Each board holds exactly 100 items** (`total` is always 100) — this is a leaderboard,\nnot a full search; upstream only exposes the Top 100. With `page_size=34` you reach the\nend at page 3, and page 4 returns an empty array. For more content switch boards, filters\nor `date_range` — **raising `page_size` does not help** (capped at 34).\n\n`pageInfoDto.totalPage` is always `0` in practice — **do not use it** to detect more pages.\n\n### 3. Leaderboards (`biz_type`)\n| Value | Board | Content |\n|---|---|---|\n| `1` | Xiaohongshu Hot | Platform-wide hot content |\n| `2` | Product Seeding | Content aimed at product seeding |\n| `3` | E-commerce Promotion | Content promoting goods or live streams |\n| `4` | PGY Cooperation | Sponsored notes from PGY bloggers |\n| `5` | Lead Collection | Content aimed at lead collection |\n| `6` | E-commerce Hot | Hot e-commerce product content |\n| `7` | Direct Seeding | Content aimed at direct seeding |\n| `8` | App Promotion | Content promoting apps |\n\n### 4. Filters Differ per Board\nThe board determines which filters are available — sending an unsupported field returns\n**422** listing what the board does support, instead of being silently ignored (otherwise\nyou would receive unfiltered data without noticing).\n\n| Board | Available filters |\n|---|---|\n| `1` | `category`, `note_type`, `content_type` |\n| `2` / `5` / `7` | `industry`, `placement`, `note_type`, `content_type`, `theme` |\n| `3` | `industry`, `placement`, `note_type`, `content_type`, `marketing_target` |\n| `4` | `industry`, `note_type`, `author_type`, `theme`, `price`, `fans` |\n| `6` | `industry`, `note_type`, `content_type` |\n| `8` | `industry`, `placement`, `note_type`, `content_type`, `theme`, `sub_biz_type` |\n\n**How to fill industry** (different boards use different taxonomies — do not mix them):\n\n| Board | Field | Values |\n|---|---|---|\n| `1` | `category` | `内容类目#X` or `所属行业#X`, e.g. `内容类目#美妆` |\n| `2/4/5/7/8` | `industry` | Industry names (母婴, 美妆个护, 3C数码, ... 25 in total) |\n| `3/6` | `industry` | E-commerce product categories (茶, 厨房电器, ... hundreds, a different taxonomy) |\n\n### 5. Sorting (`order_by`)\nLeave empty to use the board default (boards 2 and 3 default to read rate, others to impressions).\n\nCommon to all boards:\n\n| Value | Meaning | Value | Meaning |\n|---|---|---|---|\n| `premium_imp_num` | Impressions | `premium_engage_rate` | Engagement rate |\n| `premium_read_num` | Reads | `premium_like_num` | Likes |\n| `premium_ctr` | Read rate | `premium_fav_num` | Favorites |\n| `premium_engage_num` | Engagements | `premium_cmt_num` | Comments |\n\nBoards `3` / `6` additionally support `premium_ecm_dgmv` (paid GMV),\n`premium_ecm_order_pv` (paid orders), `premium_ecm_order_rate` (paid conversion rate).\n\nBoard `4` additionally supports off-site metrics for Taobao, JD, and VIP:\n`taobao_third_active_pgy_user_ratio` / `_cost`, `jd_third_active_pgy_user_ratio` / `_cost`,\n`wph_third_active_pgy_user_ratio` / `_cost`.\n\nSending a sort value the board does not support also returns 422.\n\n### 6. Other Enums\n| Param | Web name | All values |\n|---|---|---|\n| `note_type` | Content type | `1` image-text, `2` video |\n| `content_type` | Content source | `1` blogger sponsored, `2` celebrity sponsored, `3` employee, `5` buyer, `6` pro account, `11` owner, `-1` user (values are non-contiguous) |\n| `author_type` | Creator type | `1` PGY blogger, `2` celebrity |\n| `placement` | Traffic placement | `1` discovery, `2` search, `3` in-video feed |\n| `marketing_target` | Marketing target | `3` product promotion, `8` live promotion |\n| `sub_biz_type` | App action | `1` app download, `2` mini-program, `3` app open |\n| `date_range` | Time window | `3`, `7`, `14`, `30` (last N days) |\n| `theme` | Theme | 21 Chinese theme names (开箱, 测评类, 好物合集, ...) |\n\n`price` (board 4) needs both the quote type and the range, because image-text and video are\ntwo independent quotes: `{\"kind\": 1, \"range\": {\"min\": 10000, \"max\": 50000}}` where `kind`\nis `1` image-text / `2` video. `fans` (board 4) takes a plain range.\n\n### 7. Return\n- `noteList[]`: matched notes; each has `noteInfo` (title, noteType, noteLink, noteImages,\n readNum, likeNum, favNum, cmtNum, videoDuration, notePublishTime) plus blogger info\n- `total`: always **100** (board capacity)\n- `pageInfoDto`: upstream paging echo; its `totalPage` is always `0` and unusable\n\n### 8. Notes\n- **Misspelled fields, invalid enums, and board/filter mismatches all return 422**\n- Keyword supports comma-separated batch search (same as the web search box)\n\n### Response shape (two layers)\n- `resp[\"data\"]` is PGY's raw envelope (with `code`/`msg`/`success`); the payload is one level deeper\n- Correct access: `data = resp[\"data\"][\"data\"]` — every field listed under \"Return\" lives here\n\n### Billing\n- HTTP 200 → **charged**, including \"no result\" (`data` is null, e.g. ID not found or filters matched\n nothing): the request did reach PGY, so retrying on empty data just burns quota\n- HTTP 400 → not charged (malformed params, or upstream unavailable/error)\n\nCategory, industry, and theme names are protocol values. Copy the original Chinese labels verbatim; do not translate them.\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_xiaohongshu_pgy_get_content_square", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### 7. Return\n- `noteList[]`: matched notes; each has `noteInfo` (title, noteType, noteLink, noteImages,\n readNum, likeNum, favNum, cmtNum, videoDuration, notePublishTime) plus blogger info\n- `total`: always **100** (board capacity)\n- `pageInfoDto`: upstream paging echo; its `totalPage` is always `0` and unusable\n\n### Response shape (two layers)\n- `resp[\"data\"]` is PGY's raw envelope (with `code`/`msg`/`success`); the payload is one level deeper\n- Correct access: `data = resp[\"data\"][\"data\"]` — every field listed under \"Return\" lives here", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "xiaohongshu get_content_square", "tags": [ "tikhub.xiaohongshu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "3d0d462efb84" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/xiaohongshu/pgy/get_content_square", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_xiaohongshu_pgy_get_content_square", "method": "POST", "path": "/apis/v1/tikhub/xiaohongshu/pgy/get_content_square" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "biz_type": { "type": "integer", "enum": [ 1, 2, 3, 4, 5, 6, 7, 8 ], "title": "Biz Type", "description": "Leaderboard: 1=Xiaohongshu Popular, 2=Product Seeding, 3=E-commerce Promotion, 4=Dandelion Collaboration, 5=Lead Collection, 6=E-commerce Hot, 7=Direct Seeding, 8=App Promotion", "example": 1 }, "page_num": { "type": "integer", "maximum": 100.0, "minimum": 1.0, "title": "Page Num", "description": "Page number, 1-100. Each board exposes only 100 items; keep all other parameters unchanged between pages.", "default": 1, "example": 1 }, "page_size": { "type": "integer", "maximum": 34.0, "minimum": 1.0, "title": "Page Size", "description": "Items per page, 1-34; defaults to 34 as on the web page.", "default": 34, "example": 34 }, "search_word": { "type": "string", "maxLength": 100, "title": "Search Word", "description": "Search keyword; leave empty to view the full board. Supports comma-separated batch search.", "default": "", "example": "Face Mask" }, "order_by": { "type": "string", "maxLength": 64, "title": "Order By", "description": "Sort field. Leave empty to use the default for the selected board; see the endpoint sort-key table.", "default": "", "example": "premium_imp_num" }, "date_range": { "type": "integer", "enum": [ 3, 7, 14, 30 ], "title": "Date Range", "description": "Date window in days: 3, 7 (default), 14, or 30.", "default": 7, "example": 7 }, "sub_biz_type": { "title": "Sub Biz Type", "description": "Board 8 only: 1=app download, 2=mini-program promotion, 3=app re-engagement (default).", "example": 3, "type": [ "integer", "null" ], "enum": [ 1, 2, 3, null ] }, "category": { "title": "Category", "description": "Board 1 only. Category uses the literal prefixes \"内容类目#\" or \"所属行业#\" followed by an original Chinese label, for example \"内容类目#美妆\". Copy labels verbatim; do not translate them.", "example": "内容类目#美妆", "type": [ "string", "null" ], "maxLength": 64 }, "industry": { "title": "Industry", "description": "Industry name, used by boards 2/3/4/5/6/7/8. Copy the original Chinese label verbatim. Boards 3 and 6 use e-commerce product categories; the other boards use industry names.", "example": "母婴", "type": [ "string", "null" ], "maxLength": 64 }, "note_type": { "title": "Note Type", "description": "Content type: 1=Image+text, 2=Video", "example": 2, "type": [ "integer", "null" ], "enum": [ 1, 2, null ] }, "content_type": { "title": "Content Type", "description": "Content source: 1=Blogger partnership, 2=Celebrity partnership, 3=Employee, 5=Buyer, 6=Professional account, 11=Director, -1=User", "example": 1, "type": [ "integer", "null" ], "enum": [ 1, 2, 3, 5, 6, 11, -1, null ] }, "theme": { "title": "Theme", "description": "Theme name, used by boards 2/4/5/7/8. Copy the original Chinese theme label verbatim.", "example": "开箱", "type": [ "string", "null" ], "maxLength": 64 }, "author_type": { "title": "Author Type", "description": "Board 4 only: 1=Dandelion creator, 2=celebrity", "example": 1, "type": [ "integer", "null" ], "enum": [ 1, 2, null ] }, "placement": { "title": "Placement", "description": "Traffic placement (boards 2/3/5/7/8): 1=Discover feed, 2=Search, 3=In-video traffic", "example": 1, "type": [ "integer", "null" ], "enum": [ 1, 2, 3, null ] }, "marketing_target": { "title": "Marketing Target", "description": "Board 3 only: 3=product promotion, 8=live stream promotion", "example": 3, "type": [ "integer", "null" ], "enum": [ 3, 8, null ] }, "price": { "description": "Creator price (board 4 only)", "anyOf": [ { "description": "Creator price (board 4 only)", "allOf": [ { "properties": { "kind": { "type": "integer", "enum": [ 1, 2 ], "title": "Kind", "description": "Quote type: 1=image-text note, 2=video note" }, "range": { "description": "Quote range (CNY)", "allOf": [ { "properties": { "min": { "title": "Min", "description": "Minimum value (inclusive)", "type": [ "integer", "null" ], "maximum": 9999999.0, "minimum": 0.0 }, "max": { "title": "Max", "description": "Maximum value (inclusive); omit for no upper limit", "type": [ "integer", "null" ], "maximum": 9999999.0, "minimum": 0.0 } }, "additionalProperties": false, "type": "object", "title": "RangeFilter", "description": "Numeric range. Either bound may be omitted; at least one must be provided." } ] } }, "additionalProperties": false, "type": "object", "required": [ "kind", "range" ], "title": "PriceFilter", "description": "Web page \"Creator Pricing\": image-text and video are two independent channels; one must be selected first." } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "fans": { "description": "Creator follower count range (board 4 only)", "anyOf": [ { "description": "Creator follower count range (board 4 only)", "allOf": [ { "properties": { "min": { "title": "Min", "description": "Minimum value (inclusive)", "type": [ "integer", "null" ], "maximum": 9999999.0, "minimum": 0.0 }, "max": { "title": "Max", "description": "Maximum value (inclusive); omit for no upper limit", "type": [ "integer", "null" ], "maximum": 9999999.0, "minimum": 0.0 } }, "additionalProperties": false, "type": "object", "title": "RangeFilter", "description": "Numeric range. Either bound may be omitted; at least one must be provided." } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] } }, "additionalProperties": false, "type": "object", "required": [ "biz_type" ], "title": "ContentSquareReq" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:edcf5af75107dd013d0766960d70ddc06cf1c87a0f41af13e2ec1e2adbd42737" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/xiaohongshu/pgy/get_content_square \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"biz_type\": 1\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-xiaohongshu-pgy-get_content_square" } }, "/apis/v1/tikhub/xiaohongshu/pgy/get_keyword_daily": { "post": { "description": "Xiaohongshu (pgy). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Daily search trend of a keyword — tells whether it is rising, fading, or seasonal\n\n### Request Body Parameters\n- search_word: keyword, e.g. \"face mask\"\n\n### Return\n- `dailyData[]`: one entry per day with `dateKey`, `searchScore`, `noteNum`, `userNum`\n\n### Notes\n- The time span is decided by PGY (about the last three months in practice); there is no\n adjustable time parameter here\n- For aggregates and period-over-period change, use `/tikhub/xiaohongshu/pgy/get_keyword_stat`\n\n### Response shape (two layers)\n- `resp[\"data\"]` is PGY's raw envelope (with `code`/`msg`/`success`); the payload is one level deeper\n- Correct access: `data = resp[\"data\"][\"data\"]` — every field listed under \"Return\" lives here\n\n### Billing\n- HTTP 200 → **charged**, including \"no result\" (`data` is null, e.g. ID not found or filters matched\n nothing): the request did reach PGY, so retrying on empty data just burns quota\n- HTTP 400 → not charged (malformed params, or upstream unavailable/error)\n\nAPI references: `get_keyword_stat` = `POST /tikhub/xiaohongshu/pgy/get_keyword_stat` (operationId: `post_tikhub_xiaohongshu_pgy_get_keyword_stat`).\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_xiaohongshu_pgy_get_keyword_daily", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `dailyData[]`: one entry per day with `dateKey`, `searchScore`, `noteNum`, `userNum`\n\n### Response shape (two layers)\n- `resp[\"data\"]` is PGY's raw envelope (with `code`/`msg`/`success`); the payload is one level deeper\n- Correct access: `data = resp[\"data\"][\"data\"]` — every field listed under \"Return\" lives here", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "xiaohongshu get_keyword_daily", "tags": [ "tikhub.xiaohongshu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "e99a64a6ad98" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/xiaohongshu/pgy/get_keyword_daily", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_xiaohongshu_pgy_get_keyword_daily", "method": "POST", "path": "/apis/v1/tikhub/xiaohongshu/pgy/get_keyword_daily" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "search_word": { "type": "string", "maxLength": 100, "minLength": 1, "title": "Search Word", "description": "Keyword, e.g., face mask", "example": "Face Mask" } }, "additionalProperties": false, "type": "object", "required": [ "search_word" ], "title": "KeywordReq" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:b1e91b8009e48bfb5587a84ea6eb98ebf1a4db7b573ca7b4aa7d6999e4aad85e" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/xiaohongshu/pgy/get_keyword_daily \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"search_word\": \"Face Mask\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-xiaohongshu-pgy-get_keyword_daily" } }, "/apis/v1/tikhub/xiaohongshu/pgy/get_keyword_related": { "post": { "description": "Xiaohongshu (pgy). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- What users search **before** and **after** this keyword (\"Related Inspiration\" card)\n- Typical use: expand one seed keyword into a candidate list, then compare each with\n `/tikhub/xiaohongshu/pgy/get_keyword_stat` to find low-competition but decent-volume terms\n\n### Request Body Parameters\n- search_word: keyword, e.g. \"face mask\"\n\n### Return\n- `upSearchWords[]` (upstream terms) and `downSearchWords[]` (downstream terms)\n- Each term carries `searchScore`, `readTotalCount`, `noteNum`, `relevanceRank`, `brandTag`\n\n### Response shape (two layers)\n- `resp[\"data\"]` is PGY's raw envelope (with `code`/`msg`/`success`); the payload is one level deeper\n- Correct access: `data = resp[\"data\"][\"data\"]` — every field listed under \"Return\" lives here\n\n### Billing\n- HTTP 200 → **charged**, including \"no result\" (`data` is null, e.g. ID not found or filters matched\n nothing): the request did reach PGY, so retrying on empty data just burns quota\n- HTTP 400 → not charged (malformed params, or upstream unavailable/error)\n\nAPI references: `get_keyword_stat` = `POST /tikhub/xiaohongshu/pgy/get_keyword_stat` (operationId: `post_tikhub_xiaohongshu_pgy_get_keyword_stat`).\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_xiaohongshu_pgy_get_keyword_related", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `upSearchWords[]` (upstream terms) and `downSearchWords[]` (downstream terms)\n- Each term carries `searchScore`, `readTotalCount`, `noteNum`, `relevanceRank`, `brandTag`\n\n### Response shape (two layers)\n- `resp[\"data\"]` is PGY's raw envelope (with `code`/`msg`/`success`); the payload is one level deeper\n- Correct access: `data = resp[\"data\"][\"data\"]` — every field listed under \"Return\" lives here", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "xiaohongshu get_keyword_related", "tags": [ "tikhub.xiaohongshu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "8ae17c72386d" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/xiaohongshu/pgy/get_keyword_related", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_xiaohongshu_pgy_get_keyword_related", "method": "POST", "path": "/apis/v1/tikhub/xiaohongshu/pgy/get_keyword_related" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "search_word": { "type": "string", "maxLength": 100, "minLength": 1, "title": "Search Word", "description": "Keyword, e.g., face mask", "example": "Face Mask" } }, "additionalProperties": false, "type": "object", "required": [ "search_word" ], "title": "KeywordReq" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:8def2ea54f7572ab553977a364e4aff917af1d344444b34495c3e0dd39545fbc" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/xiaohongshu/pgy/get_keyword_related \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"search_word\": \"Face Mask\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-xiaohongshu-pgy-get_keyword_related" } }, "/apis/v1/tikhub/xiaohongshu/pgy/get_keyword_stat": { "post": { "description": "Xiaohongshu (pgy). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Site-wide popularity overview of a keyword, plus the profile of bloggers posting about it\n- Corresponds to the \"Site Data\" + \"Blogger Profile\" cards in the PGY content square\n\n### Request Body Parameters\n- search_word: keyword, e.g. \"face mask\"\n\n### Return\n| Object | Fields |\n|---|---|\n| `searchWordData` | `searchScore`, `noteNum`, `userNum`, `readNum`; each has a `*30bm` counterpart = 30-day change in percent |\n| `wordKolProfile` | Blogger profile: content category share, persona share |\n\n### Related\n- `/tikhub/xiaohongshu/pgy/get_keyword_daily` for the daily trend, `/tikhub/xiaohongshu/pgy/get_keyword_related` for up/downstream keywords\n- The three endpoints are independent; call whichever you need\n\n### Response shape (two layers)\n- `resp[\"data\"]` is PGY's raw envelope (with `code`/`msg`/`success`); the payload is one level deeper\n- Correct access: `data = resp[\"data\"][\"data\"]` — every field listed under \"Return\" lives here\n\n### Billing\n- HTTP 200 → **charged**, including \"no result\" (`data` is null, e.g. ID not found or filters matched\n nothing): the request did reach PGY, so retrying on empty data just burns quota\n- HTTP 400 → not charged (malformed params, or upstream unavailable/error)\n\nAPI references: `get_keyword_daily` = `POST /tikhub/xiaohongshu/pgy/get_keyword_daily` (operationId: `post_tikhub_xiaohongshu_pgy_get_keyword_daily`); `get_keyword_related` = `POST /tikhub/xiaohongshu/pgy/get_keyword_related` (operationId: `post_tikhub_xiaohongshu_pgy_get_keyword_related`).\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_xiaohongshu_pgy_get_keyword_stat", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n| Object | Fields |\n|---|---|\n| `searchWordData` | `searchScore`, `noteNum`, `userNum`, `readNum`; each has a `*30bm` counterpart = 30-day change in percent |\n| `wordKolProfile` | Blogger profile: content category share, persona share |\n\n### Response shape (two layers)\n- `resp[\"data\"]` is PGY's raw envelope (with `code`/`msg`/`success`); the payload is one level deeper\n- Correct access: `data = resp[\"data\"][\"data\"]` — every field listed under \"Return\" lives here", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "xiaohongshu get_keyword_stat", "tags": [ "tikhub.xiaohongshu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "7ab943a9e2f9" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/xiaohongshu/pgy/get_keyword_stat", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_xiaohongshu_pgy_get_keyword_stat", "method": "POST", "path": "/apis/v1/tikhub/xiaohongshu/pgy/get_keyword_stat" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "search_word": { "type": "string", "maxLength": 100, "minLength": 1, "title": "Search Word", "description": "Keyword, e.g., face mask", "example": "Face Mask" } }, "additionalProperties": false, "type": "object", "required": [ "search_word" ], "title": "KeywordReq" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:c4a501402b047348706ed7e50c806b81eb0d27188a4369edac9af1a646fe5760" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/xiaohongshu/pgy/get_keyword_stat \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"search_word\": \"Face Mask\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-xiaohongshu-pgy-get_keyword_stat" } }, "/apis/v1/tikhub/xiaohongshu/pgy/get_live_blogger_list": { "post": { "description": "Xiaohongshu (pgy). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Replica of PGY \"Find Bloggers → Live Blogger Square\"; filter live-commerce bloggers by\n e-commerce conversion, live performance and fans purchasing power\n\n### 1. Difference from the Note Blogger Square\nThey are **two parallel entry points** with almost no overlapping filters (note seeding vs.\nlive commerce), but they **return the same blogger ID space**, so results are cross-usable.\n\n### 2. Filter Groups\n| Group | Covers |\n|---|---|\n| `nick_name` | Search by nickname (top-level param, not a group) |\n| `category` | Cooperation categories (level 1 + 2) |\n| `buyer` | Buyer groups, content personas |\n| `ecom` | Average GMV, partner-brand average GMV, average transaction value |\n| `live` | Live plans (and plan dates) + live performance (avg viewers, peak online) |\n| `fans` | Fans count, age, gender, consumption power |\n| `flags` | Actively seeking cooperation, high reply rate, contact visible, worked with brands, follow relations, high live potential, daily broadcaster, celebrity |\n\n### 3. Range Fields (value = `{\"min\": x, \"max\": y}`)\n| Path | Web filter |\n|---|---|\n| `fans.count` | Fans count |\n| `ecom.avg_gmv` / `ecom.brand_avg_gmv` | Average GMV / partner-brand average GMV (CNY) |\n| `ecom.atv` | Average transaction value (CNY). Upstream matches by **tier**, so any overlapping tier is included |\n| `live.avg_viewer` / `live.max_online` | Average viewers / peak concurrent viewers |\n\n### 4. Boolean Flags (value = `true`)\n| Path | Web filter |\n|---|---|\n| `live.has_plan` | Has live plans (use with `live.plan_days`, format YYYYMMDD) |\n| `flags.actively_seeking` / `flags.high_reply_rate` | Actively seeking / high invitation reply rate |\n| `flags.contact_visible` / `flags.cooperated_before` | Contact visible / worked on sponsored deals |\n| `flags.following` / `flags.follower` | You follow them / they follow you |\n| `flags.live_potential_high` / `flags.daily_buyer` / `flags.is_star` | High live potential / daily broadcaster / celebrity |\n\n### 5. Paging (**`seed` is specific to this endpoint**)\n| Param | Range | Note |\n|---|---|---|\n| `page_num` | **1-250** | Upstream exposes only the first 5000 items; page 251+ is empty |\n| `page_size` | **1-20** | Fixed at 20 on the web page |\n| `seed` | int | Result-set seed, see below |\n\nRanking here is **randomized**, so paging without a stable `seed` causes duplicates or gaps.\nEcho back the `seed` from the previous response; send `0` for the first page (and echo `0`\nback if that is what the response contains). Keep all other filters unchanged.\n\n**`total` is not the pageable count**: `total` is the match count (possibly millions), while\nonly `page_total` (always 5000) is actually reachable.\n\n### 6. Return\n`distributor_info_list[]` — matched live sellers, each with two objects:\n- `distributor_data_info`: `distributor_id` (= blogger `userId`) / `red_id` /\n `distributor_name` / `fans_num` / `atv` (ATV tier) / `avg_sale_amount` (avg GMV) /\n `avg_live_viewer_num` / `max_online_people_num` / `distribution_live_num` (sessions) /\n `content_categorys` / `city`\n- `distributor_extra_info`: intended categories, commission, contact, level\n\nPlus `total` (match count) / `page_total` (paging cap) / `seed` (echo back when paging) /\n`req_id`.\n\n### Response shape (two layers)\n- `resp[\"data\"]` is PGY's raw envelope (with `code`/`msg`/`success`); the payload is one level deeper\n- Correct access: `data = resp[\"data\"][\"data\"]` — every field listed under \"Return\" lives here\n\n### Billing\n- HTTP 200 → **charged**, including \"no result\" (`data` is null, e.g. ID not found or filters matched\n nothing): the request did reach PGY, so retrying on empty data just burns quota\n- HTTP 400 → not charged (malformed params, or upstream unavailable/error)\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_xiaohongshu_pgy_get_live_blogger_list", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### 6. Return\n`distributor_info_list[]` — matched live sellers, each with two objects:\n- `distributor_data_info`: `distributor_id` (= blogger `userId`) / `red_id` /\n `distributor_name` / `fans_num` / `atv` (ATV tier) / `avg_sale_amount` (avg GMV) /\n `avg_live_viewer_num` / `max_online_people_num` / `distribution_live_num` (sessions) /\n `content_categorys` / `city`\n- `distributor_extra_info`: intended categories, commission, contact, level\n\nPlus `total` (match count) / `page_total` (paging cap) / `seed` (echo back when paging) /\n`req_id`.\n\n### Response shape (two layers)\n- `resp[\"data\"]` is PGY's raw envelope (with `code`/`msg`/`success`); the payload is one level deeper\n- Correct access: `data = resp[\"data\"][\"data\"]` — every field listed under \"Return\" lives here", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "xiaohongshu get_live_blogger_list", "tags": [ "tikhub.xiaohongshu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "ff081fa0afe7" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/xiaohongshu/pgy/get_live_blogger_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_xiaohongshu_pgy_get_live_blogger_list", "method": "POST", "path": "/apis/v1/tikhub/xiaohongshu/pgy/get_live_blogger_list" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "page_num": { "type": "integer", "maximum": 250.0, "minimum": 1.0, "title": "Page Num", "description": "Page, 1-250", "default": 1, "example": 1 }, "page_size": { "type": "integer", "maximum": 20.0, "minimum": 1.0, "title": "Page Size", "description": "Page size, 1-20 (web fixed at 20)", "default": 20, "example": 20 }, "seed": { "type": "integer", "minimum": 0.0, "title": "Seed", "description": "Paging seed, echo back from previous page", "default": 0, "example": 0 }, "nick_name": { "type": "string", "maxLength": 50, "title": "Nick Name", "description": "Search by nickname", "default": "", "example": "Li" }, "category": { "description": "Cooperation category filters", "anyOf": [ { "description": "Cooperation category filters", "allOf": [ { "properties": { "first": { "title": "First", "description": "Primary cooperation category, e.g. Women's Apparel / Women's Premium. Refer to the \"Cooperation Category\" on the Pugongying \"Live Blogger Plaza\" page. Passing only the primary level is sufficient.", "items": { "type": "string", "maxLength": 64 }, "type": [ "array", "null" ], "maxItems": 30 }, "second": { "title": "Second", "description": "Secondary cooperation category, e.g. Dress. May be left empty; filtering by primary level alone is also effective.", "items": { "type": "string", "maxLength": 64 }, "type": [ "array", "null" ], "maxItems": 200 } }, "additionalProperties": false, "type": "object", "title": "CategoryFilter", "description": "Web page \"Cooperation Category\" section (primary + secondary; secondary must match the selected primary)." } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "buyer": { "description": "Buyer group & persona filters", "anyOf": [ { "description": "Buyer group & persona filters", "allOf": [ { "properties": { "group_tag": { "title": "Group Tag", "description": "Buyer group tag, e.g. Elegant Minimalist (leaf tags under style groups: Fashion Style / Body Type / Beauty & Skincare / Sports Enthusiast). Refer to the \"Buyer Group\" dropdown on the page for valid values.", "items": { "type": "string", "maxLength": 64 }, "type": [ "array", "null" ], "maxItems": 30 }, "persona_tag": { "title": "Persona Tag", "description": "Content persona tags, e.g. Model (leaf nodes from groups: Professional Identity / Family Role / Distinctive Background / Style / Lifestyle / Skin Type / Skincare / Body Type). Refer to the \"Content Persona\" dropdown on the page.", "items": { "type": "string", "maxLength": 64 }, "type": [ "array", "null" ], "maxItems": 30 } }, "additionalProperties": false, "type": "object", "title": "BuyerFilter", "description": "Web page \"Top Buyer Squad\" + \"Content Persona\" section." } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "ecom": { "description": "E-commerce conversion filters", "anyOf": [ { "description": "E-commerce conversion filters", "allOf": [ { "properties": { "avg_gmv": { "description": "Average sales per session (CNY)", "anyOf": [ { "description": "Average sales per session (CNY)", "allOf": [ { "properties": { "min": { "title": "Min", "description": "Minimum value (inclusive)", "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 }, "max": { "title": "Max", "description": "Maximum value (inclusive); omit for no upper limit", "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 } }, "additionalProperties": false, "type": "object", "title": "RangeFilter", "description": "Numeric range corresponding to the web filter tier or custom input box. Either bound may be omitted; at least one must be provided." } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "brand_avg_gmv": { "description": "Average sales per session for partnered brands (CNY)", "anyOf": [ { "description": "Average sales per session for partnered brands (CNY)", "allOf": [ { "properties": { "min": { "title": "Min", "description": "Minimum value (inclusive)", "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 }, "max": { "title": "Max", "description": "Maximum value (inclusive); omit for no upper limit", "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 } }, "additionalProperties": false, "type": "object", "title": "RangeFilter", "description": "Numeric range corresponding to the web filter tier or custom input box. Either bound may be omitted; at least one must be provided." } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "atv": { "description": "Average order value (CNY). Matched by tier (0-100 / 100-200 / 200-500 ...). Any tier overlapping with the specified range will be included — e.g. passing 100-300 will also return buyers in the 200-500 tier.", "anyOf": [ { "description": "Average order value (CNY). Matched by tier (0-100 / 100-200 / 200-500 ...). Any tier overlapping with the specified range will be included — e.g. passing 100-300 will also return buyers in the 200-500 tier.", "allOf": [ { "properties": { "min": { "title": "Min", "description": "Minimum value (inclusive)", "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 }, "max": { "title": "Max", "description": "Maximum value (inclusive); omit for no upper limit", "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 } }, "additionalProperties": false, "type": "object", "title": "RangeFilter", "description": "Numeric range corresponding to the web filter tier or custom input box. Either bound may be omitted; at least one must be provided." } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] } }, "additionalProperties": false, "type": "object", "title": "EcomFilter", "description": "Web page \"E-commerce Conversion Power\" section." } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "live": { "description": "Live activity & performance filters", "anyOf": [ { "description": "Live activity & performance filters", "allOf": [ { "properties": { "has_plan": { "title": "Has Plan", "description": "Has live-stream plan", "type": [ "boolean", "null" ] }, "plan_days": { "title": "Plan Days", "description": "Planned live stream date in YYYYMMDD; used with has_plan; leave empty for all dates", "items": { "type": "string", "pattern": "^\\d{8}$" }, "type": [ "array", "null" ], "maxItems": 60 }, "avg_viewer": { "description": "Average viewers per session", "anyOf": [ { "description": "Average viewers per session", "allOf": [ { "properties": { "min": { "title": "Min", "description": "Minimum value (inclusive)", "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 }, "max": { "title": "Max", "description": "Maximum value (inclusive); omit for no upper limit", "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 } }, "additionalProperties": false, "type": "object", "title": "RangeFilter", "description": "Numeric range corresponding to the web filter tier or custom input box. Either bound may be omitted; at least one must be provided." } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "max_online": { "description": "Peak concurrent viewers", "anyOf": [ { "description": "Peak concurrent viewers", "allOf": [ { "properties": { "min": { "title": "Min", "description": "Minimum value (inclusive)", "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 }, "max": { "title": "Max", "description": "Maximum value (inclusive); omit for no upper limit", "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 } }, "additionalProperties": false, "type": "object", "title": "RangeFilter", "description": "Numeric range corresponding to the web filter tier or custom input box. Either bound may be omitted; at least one must be provided." } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] } }, "additionalProperties": false, "type": "object", "title": "LiveFilter", "description": "Web page \"Live Stream Engagement\" + \"Live Stream Performance\" section." } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "fans": { "description": "Fans purchasing power filters", "anyOf": [ { "description": "Fans purchasing power filters", "allOf": [ { "properties": { "count": { "description": "Follower count", "anyOf": [ { "description": "Follower count", "allOf": [ { "properties": { "min": { "title": "Min", "description": "Minimum value (inclusive)", "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 }, "max": { "title": "Max", "description": "Maximum value (inclusive); omit for no upper limit", "type": [ "number", "null" ], "maximum": 1000000000000.0, "minimum": 0.0 } }, "additionalProperties": false, "type": "object", "title": "RangeFilter", "description": "Numeric range corresponding to the web filter tier or custom input box. Either bound may be omitted; at least one must be provided." } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "age": { "title": "Age", "description": "Audience age (dominant group): 0=No limit, 1=Under 18, 2=18-24, 3=25-34, 4=35-44, 5=Over 44", "type": [ "integer", "null" ], "enum": [ 0, 1, 2, 3, 4, 5, null ] }, "gender": { "title": "Gender", "description": "Audience gender: 0=No limit, 1=Predominantly male, 2=Predominantly female", "type": [ "integer", "null" ], "enum": [ 0, 1, 2, null ] }, "consumption": { "title": "Consumption", "description": "Audience purchasing power: high / middle / low", "items": { "type": "string", "enum": [ "high", "middle", "low" ] }, "type": [ "array", "null" ], "maxItems": 3 } }, "additionalProperties": false, "type": "object", "title": "FansFilter", "description": "Audience purchasing power: follower count, age, gender, spending power." } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "flags": { "description": "Platform recommendation flags", "anyOf": [ { "description": "Platform recommendation flags", "allOf": [ { "properties": { "actively_seeking": { "title": "Actively Seeking", "description": "Actively seeking collaborations", "type": [ "boolean", "null" ] }, "high_reply_rate": { "title": "High Reply Rate", "description": "High invitation response rate", "type": [ "boolean", "null" ] }, "contact_visible": { "title": "Contact Visible", "description": "Contact information viewable", "type": [ "boolean", "null" ] }, "cooperated_before": { "title": "Cooperated Before", "description": "Has worked on commercial orders", "type": [ "boolean", "null" ] }, "following": { "title": "Following", "description": "You follow them", "type": [ "boolean", "null" ] }, "follower": { "title": "Follower", "description": "They follow you", "type": [ "boolean", "null" ] }, "live_potential_high": { "title": "Live Potential High", "description": "High live streaming potential", "type": [ "boolean", "null" ] }, "daily_buyer": { "title": "Daily Buyer", "description": "Daily live-stream buyer", "type": [ "boolean", "null" ] }, "is_star": { "title": "Is Star", "description": "Celebrity", "type": [ "boolean", "null" ] } }, "additionalProperties": false, "type": "object", "title": "FlagFilter", "description": "Web page \"Platform Recommendations -> Featured Bloggers\" section (all checkboxes)." } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] } }, "additionalProperties": false, "type": "object", "title": "LiveBloggerReq" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:27524d7449e2887a51f695683a73a667db0fdf74b0bbf80c41d4f8cb5a460b01" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-xiaohongshu-pgy-get_live_blogger_list" } }, "/apis/v1/tikhub/xiaohongshu/pgy/get_note_comments": { "post": { "description": "Xiaohongshu (pgy). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get the featured comments of a single note, including the blogger's own replies\n- Mirrors the \"Featured Comments\" block in the PGY note detail dialog\n\n### Request Body Parameters\n- note_id: Note ID, e.g. \"6a85646a0000000006005aea\"\n (from the upstream V1 note-list endpoint (not exposed in this specification) list[].noteId, /tikhub/xiaohongshu/pgythe upstream V1 note-list endpoint (not exposed in this specification)_v2\n noteList[].noteInfo.noteId, or /tikhub/xiaohongshu/pgy/get_content_square results)\n\n### No paging\n- Upstream always returns **5 items** and does not support paging, so this endpoint\n exposes no paging parameters\n- Verified: pageIndex 0/1/2/5/20 and pageSize 5/10/20/50/100 all return the very same\n batch (identical comment.idStr) — it is a fixed \"top 5 featured\", not a comment feed\n\n### Return\n- `data.data` is an **array** (not an object); each item is one comment thread:\n - comment: top-level comment. content / createTime / likeCount /\n subCommentCount / idStr / userIdStr\n - l1L2Comments[]: replies under it — **the blogger's replies live here**;\n same fields as comment, targetCommentId points at the parent\n - userMap: {userIdStr: {userNickName, imageUrl, gender}}\n- ⚠️ **Join userMap for nicknames/avatars** — comment and l1L2Comments[] carry only userIdStr\n- ⚠️ id / noteId / userId exceed JS safe integers; always use idStr / noteIdStr / userIdStr\n\n### Response shape (two layers)\n- `resp[\"data\"]` is PGY's raw envelope (with `code`/`msg`/`success`); the payload is one level deeper\n- Correct access: `data = resp[\"data\"][\"data\"]` — every field listed under \"Return\" lives here\n\n### Billing\n- HTTP 200 → **charged**, including \"no result\" (`data` is null, e.g. ID not found or filters matched\n nothing): the request did reach PGY, so retrying on empty data just burns quota\n- HTTP 400 → not charged (malformed params, or upstream unavailable/error)\n\nAPI references: `get_content_square` = `POST /tikhub/xiaohongshu/pgy/get_content_square` (operationId: `post_tikhub_xiaohongshu_pgy_get_content_square`).\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_xiaohongshu_pgy_get_note_comments", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- `data.data` is an **array** (not an object); each item is one comment thread:\n - comment: top-level comment. content / createTime / likeCount /\n subCommentCount / idStr / userIdStr\n - l1L2Comments[]: replies under it — **the blogger's replies live here**;\n same fields as comment, targetCommentId points at the parent\n - userMap: {userIdStr: {userNickName, imageUrl, gender}}\n- ⚠️ **Join userMap for nicknames/avatars** — comment and l1L2Comments[] carry only userIdStr\n- ⚠️ id / noteId / userId exceed JS safe integers; always use idStr / noteIdStr / userIdStr\n\n### Response shape (two layers)\n- `resp[\"data\"]` is PGY's raw envelope (with `code`/`msg`/`success`); the payload is one level deeper\n- Correct access: `data = resp[\"data\"][\"data\"]` — every field listed under \"Return\" lives here", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "xiaohongshu get_note_comments", "tags": [ "tikhub.xiaohongshu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "68002d0a5cc6" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/xiaohongshu/pgy/get_note_comments", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_xiaohongshu_pgy_get_note_comments", "method": "POST", "path": "/apis/v1/tikhub/xiaohongshu/pgy/get_note_comments" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "note_id": { "type": "string", "title": "Note Id", "description": "Note ID", "example": "6a20edfa0000000021020951" } }, "additionalProperties": false, "type": "object", "required": [ "note_id" ], "title": "NoteDetailReq" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:6d65e781e117339037f49e01efd5a768abf8acae45908f608fb7531bd3680d8e" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/xiaohongshu/pgy/get_note_comments \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"note_id\": \"6a20edfa0000000021020951\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-xiaohongshu-pgy-get_note_comments" } }, "/apis/v1/tikhub/xiaohongshu/pgy/get_note_components": { "post": { "description": "Xiaohongshu (pgy). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get the components attached to a single note (content search / comment-area / bottom)\n- Mirrors the component tags under the title in the PGY note detail dialog\n\n### Request Body Parameters\n- note_id: Note ID, same sources as /tikhub/xiaohongshu/pgy/get_note_comments\n\n### Not a duplicate of compClickData in get_note_detail\n- This endpoint returns component **configuration**: which component, search word,\n brand, blogger, button label, jump target\n- compClickData returns component **click-rate tiers**: normal / high / very high\n (thresholds 0-2% / 2%-10% / 10%+)\n\n### Return\n- Three component slots under `data.data`, **null when the component is not attached**:\n - noteContent: content component. subType (e.g. NOTE_CONTENT_SEARCH) / searchWord /\n brandName / gameAppId\n - noteComment: comment-area component. componentInfo (subType / name / buttonName /\n content / jumpType, jumpUrl / type) + brandInfo + kolInfo\n - noteBottom: bottom component; empirically null for most notes\n- Useful for seeing which conversion component a sponsored note carries and where it points\n\n### Response shape (two layers)\n- `resp[\"data\"]` is PGY's raw envelope (with `code`/`msg`/`success`); the payload is one level deeper\n- Correct access: `data = resp[\"data\"][\"data\"]` — every field listed under \"Return\" lives here\n\n### Billing\n- HTTP 200 → **charged**, including \"no result\" (`data` is null, e.g. ID not found or filters matched\n nothing): the request did reach PGY, so retrying on empty data just burns quota\n- HTTP 400 → not charged (malformed params, or upstream unavailable/error)\n\nAPI references: `get_note_comments` = `POST /tikhub/xiaohongshu/pgy/get_note_comments` (operationId: `post_tikhub_xiaohongshu_pgy_get_note_comments`); `get_note_detail` = `POST /tikhub/xiaohongshu/pgy/get_note_detail` (operationId: `post_tikhub_xiaohongshu_pgy_get_note_detail`).\n\n\nPublished reference price: $0.0001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_xiaohongshu_pgy_get_note_components", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Three component slots under `data.data`, **null when the component is not attached**:\n - noteContent: content component. subType (e.g. NOTE_CONTENT_SEARCH) / searchWord /\n brandName / gameAppId\n - noteComment: comment-area component. componentInfo (subType / name / buttonName /\n content / jumpType, jumpUrl / type) + brandInfo + kolInfo\n - noteBottom: bottom component; empirically null for most notes\n- Useful for seeing which conversion component a sponsored note carries and where it points\n\n### Response shape (two layers)\n- `resp[\"data\"]` is PGY's raw envelope (with `code`/`msg`/`success`); the payload is one level deeper\n- Correct access: `data = resp[\"data\"][\"data\"]` — every field listed under \"Return\" lives here", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "xiaohongshu get_note_components", "tags": [ "tikhub.xiaohongshu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.0001, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "c64da6a0f8dc" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/xiaohongshu/pgy/get_note_components", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_xiaohongshu_pgy_get_note_components", "method": "POST", "path": "/apis/v1/tikhub/xiaohongshu/pgy/get_note_components" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "note_id": { "type": "string", "title": "Note Id", "description": "Note ID", "example": "6a20edfa0000000021020951" } }, "additionalProperties": false, "type": "object", "required": [ "note_id" ], "title": "NoteDetailReq" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:0f4dbff98a153df46a5a062c1f46c3a95456f366353096180447055f5a3d10e9" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/xiaohongshu/pgy/get_note_components \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"note_id\": \"6a20edfa0000000021020951\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-xiaohongshu-pgy-get_note_components" } }, "/apis/v1/tikhub/xiaohongshu/pgy/get_note_detail": { "post": { "description": "Xiaohongshu (pgy). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get detail data of a single PGY (Pugongying) note\n\n### Request Body Parameters\n- note_id: Note ID, e.g. \"6a20edfa0000000021020951\"\n\n### Return\n- Note detail data:\n - Basics: noteId / noteLink / title / content / type / createTime\n - Author: userId / name / headPhoto\n - Media: imagesList[] (url with width/height) / videoInfo\n - Metrics: impNum / readNum / likeNum / favNum / cmtNum\n\n### Response shape (two layers)\n- `resp[\"data\"]` is PGY's raw envelope (with `code`/`msg`/`success`); the payload is one level deeper\n- Correct access: `data = resp[\"data\"][\"data\"]` — every field listed under \"Return\" lives here\n\n### Billing\n- HTTP 200 → **charged**, including \"no result\" (`data` is null, e.g. ID not found or filters matched\n nothing): the request did reach PGY, so retrying on empty data just burns quota\n- HTTP 400 → not charged (malformed params, or upstream unavailable/error)\n\n\nPublished reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_xiaohongshu_pgy_get_note_detail", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Note detail data:\n - Basics: noteId / noteLink / title / content / type / createTime\n - Author: userId / name / headPhoto\n - Media: imagesList[] (url with width/height) / videoInfo\n - Metrics: impNum / readNum / likeNum / favNum / cmtNum\n\n### Response shape (two layers)\n- `resp[\"data\"]` is PGY's raw envelope (with `code`/`msg`/`success`); the payload is one level deeper\n- Correct access: `data = resp[\"data\"][\"data\"]` — every field listed under \"Return\" lives here", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "xiaohongshu get_note_detail", "tags": [ "tikhub.xiaohongshu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.02, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "96fe1d25e0b3" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/xiaohongshu/pgy/get_note_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_xiaohongshu_pgy_get_note_detail", "method": "POST", "path": "/apis/v1/tikhub/xiaohongshu/pgy/get_note_detail" }, "requestBody": { "content": { "application/json": { "schema": { "properties": { "note_id": { "type": "string", "title": "Note Id", "description": "Note ID", "example": "6a20edfa0000000021020951" } }, "additionalProperties": false, "type": "object", "required": [ "note_id" ], "title": "NoteDetailReq" } } }, "required": true }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:2d6fe16d01beac08035397ce13c8ab6a2a5e006bd9c16005f0c810d7c5cfac87" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/tikhub/xiaohongshu/pgy/get_note_detail \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"note_id\": \"6a20edfa0000000021020951\"\n}'" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-xiaohongshu-pgy-get_note_detail" } }, "/apis/v1/tikhub/xiaohongshu/web_v3/fetch_homefeed": { "get": { "description": "Xiaohongshu (web_v3).\n\n### Purpose\n- Get homepage recommended notes\n\n### API Priority\n- Xiaohongshu API priority: `App V2` > `App` > `Web V3 (this)` > `Web V2` > `Web`\n\n### Parameters\n- num (max 40), cursor_score, category, need_filter_image\n\n### Return\n- Recommended notes list\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_xiaohongshu_web_v3_fetch_homefeed", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Recommended notes list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "xiaohongshu fetch_homefeed", "tags": [ "tikhub.xiaohongshu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "751c2154acac" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/xiaohongshu/web_v3/fetch_homefeed", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_xiaohongshu_web_v3_fetch_homefeed", "method": "GET", "path": "/apis/v1/tikhub/xiaohongshu/web_v3/fetch_homefeed" }, "parameters": [ { "name": "category", "in": "query", "required": false, "schema": { "type": "string", "description": "Category channel ID obtained from /tikhub/xiaohongshu/web_v3/fetch_homefeed_categories.\n\nAPI references: `fetch_homefeed_categories` = `GET /tikhub/xiaohongshu/web_v3/fetch_homefeed_categories` (operationId: `get_tikhub_xiaohongshu_web_v3_fetch_homefeed_categories`).", "default": "homefeed_recommend", "title": "Category" }, "description": "Category channel ID obtained from /tikhub/xiaohongshu/web_v3/fetch_homefeed_categories.\n\nAPI references: `fetch_homefeed_categories` = `GET /tikhub/xiaohongshu/web_v3/fetch_homefeed_categories` (operationId: `get_tikhub_xiaohongshu_web_v3_fetch_homefeed_categories`).", "example": "homefeed_recommend" }, { "name": "cursor_score", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination cursor", "default": "", "title": "Cursor Score" }, "description": "Pagination cursor" }, { "name": "need_filter_image", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Image notes only", "default": false, "title": "Need Filter Image" }, "description": "Image notes only" }, { "name": "num", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 40, "description": "Number of results, max 40", "default": 20, "title": "Num" }, "description": "Number of results, max 40", "example": 20 } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:f2829f10a6a08fd891b4963acf2469b97098933cfa2cf08d6b345cab56664ff4" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-xiaohongshu-web_v3-fetch_homefeed" } }, "/apis/v1/tikhub/xiaohongshu/web_v3/fetch_homefeed_categories": { "get": { "description": "Xiaohongshu (web_v3).\n\n### Purpose:\n- Get homepage category channels\n### API Priority:\n- Xiaohongshu API priority: `App V2` > `App` > `Web V3 (this)` > `Web V2` > `Web`\n### Return:\n- Categories list\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_xiaohongshu_web_v3_fetch_homefeed_categories", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Categories list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "xiaohongshu fetch_homefeed_categories", "tags": [ "tikhub.xiaohongshu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "adc3bc414858" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/xiaohongshu/web_v3/fetch_homefeed_categories", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_xiaohongshu_web_v3_fetch_homefeed_categories", "method": "GET", "path": "/apis/v1/tikhub/xiaohongshu/web_v3/fetch_homefeed_categories" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e8a8b9ff70eda1b0322903a8e6838f0b3bb67d9854812985ed907831b082a980" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-xiaohongshu-web_v3-fetch_homefeed_categories" } }, "/apis/v1/tikhub/xiaohongshu/web_v3/fetch_note_detail": { "get": { "description": "Xiaohongshu (web_v3).\n\n### Purpose:\n- Get note detail (image/video)\n### API Priority:\n- Xiaohongshu API priority: `App V2` > `App` > `Web V3 (this)` > `Web V2` > `Web`\n### Parameters:\n- note_id: Note ID, can be obtained from the sharing link of Xiaohongshu\n- xsec_token: Security token, can be obtained from the sharing link of Xiaohongshu\n### Return:\n- Note detail data\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_xiaohongshu_web_v3_fetch_note_detail", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Note detail data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "xiaohongshu fetch_note_detail", "tags": [ "tikhub.xiaohongshu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "d5d7c7effc11" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/xiaohongshu/web_v3/fetch_note_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_xiaohongshu_web_v3_fetch_note_detail", "method": "GET", "path": "/apis/v1/tikhub/xiaohongshu/web_v3/fetch_note_detail" }, "parameters": [ { "name": "note_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Note ID, can be obtained from the sharing link of Xiaohongshu", "title": "Note Id" }, "description": "Note ID, can be obtained from the sharing link of Xiaohongshu", "example": "6a2f423d000000001003cb36" }, { "name": "xsec_token", "in": "query", "required": true, "schema": { "type": "string", "description": "Security token, can be obtained from the Xiaohongshu sharing link", "title": "Xsec Token" }, "description": "Security token, can be obtained from the Xiaohongshu sharing link", "example": "ABtexB6bX5HgLD42SFrK1scGUmSO8YV5_isaLrDy9sLxQ=" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:720dbd3eb0f00960151ff80cfff9a932be91abee8d6184525364c058feea5f47" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/xiaohongshu/web_v3/fetch_note_detail?note_id=6a2f423d000000001003cb36&xsec_token=ABtexB6bX5HgLD42SFrK1scGUmSO8YV5_isaLrDy9sLxQ%3D' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-xiaohongshu-web_v3-fetch_note_detail" } }, "/apis/v1/tikhub/xiaohongshu/web_v3/fetch_search_suggest": { "get": { "description": "Xiaohongshu (web_v3).\n\n### Purpose:\n- Get search suggestions, returns popular recommendations when keyword is empty\n### API Priority:\n- Xiaohongshu API priority: `App V2` > `App` > `Web V3 (this)` > `Web V2` > `Web`\n### Parameters:\n- keyword: Keyword (optional)\n### Return:\n- Suggestions list\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_xiaohongshu_web_v3_fetch_search_suggest", "responses": { "200": { "description": "Successful Response\n\n### Return\n- Suggestions list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "xiaohongshu fetch_search_suggest", "tags": [ "tikhub.xiaohongshu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "357fe1cf50ff" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/xiaohongshu/web_v3/fetch_search_suggest", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_xiaohongshu_web_v3_fetch_search_suggest", "method": "GET", "path": "/apis/v1/tikhub/xiaohongshu/web_v3/fetch_search_suggest" }, "parameters": [ { "name": "keyword", "in": "query", "required": false, "schema": { "type": "string", "description": "Keyword (optional)", "default": "", "title": "Keyword" }, "description": "Keyword (optional)", "example": "Lipstick" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:5a34ff3b03bcff0e1cf98351a48274b4bf8882fdb6cffe6c7568f7eb18c981f5" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-xiaohongshu-web_v3-fetch_search_suggest" } }, "/apis/v1/tikhub/xiaohongshu/web_v3/fetch_user_info": { "get": { "description": "Xiaohongshu (web_v3).\n\n### Purpose:\n- Get user public profile\n### API Priority:\n- Xiaohongshu API priority: `App V2` > `App` > `Web V3 (this)` > `Web V2` > `Web`\n### Parameters:\n- user_id: User ID\n### Return:\n- User info\n\n\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_xiaohongshu_web_v3_fetch_user_info", "responses": { "200": { "description": "Successful Response\n\n### Return\n- User info", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "xiaohongshu fetch_user_info", "tags": [ "tikhub.xiaohongshu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "4aa8c585194a" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/xiaohongshu/web_v3/fetch_user_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_xiaohongshu_web_v3_fetch_user_info", "method": "GET", "path": "/apis/v1/tikhub/xiaohongshu/web_v3/fetch_user_info" }, "parameters": [ { "name": "user_id", "in": "query", "required": true, "schema": { "type": "string", "description": "User ID", "title": "User Id" }, "description": "User ID", "example": "5e3a8ee700000000010070c6" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:d0dc3c822aeacf1842b7120bf12eac771273c41da499a4fdb65a95d33b4d5c04" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/xiaohongshu/web_v3/fetch_user_info?user_id=5e3a8ee700000000010070c6' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-xiaohongshu-web_v3-fetch_user_info" } }, "/apis/v1/tikhub/xigua/app/v2/fetch_one_video": { "get": { "description": "Xigua (app/v2).\n\n### Purpose\n- Get single video data (less information, does not include title and other information, but includes information about related videos)\n\n### Parameters\n- item_id: Video id\n\n### Return\n- Video data, which contains the Base64 encoded playback address of the video link, which needs to be decoded and used by the front end, or use /tikhub/xigua/app/v2/fetch_one_video_play_url to get the playback link.\n\nAPI references: `fetch_one_video_play_url` = `GET /tikhub/xigua/app/v2/fetch_one_video_play_url` (operationId: `get_tikhub_xigua_app_v2_fetch_one_video_play_url`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_xigua_app_v2_fetch_one_video", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Video data, which contains the Base64 encoded playback address of the video link, which needs to be decoded and used by the front end, or use /tikhub/xigua/app/v2/fetch_one_video_play_url to get the playback link.\n\nAPI references: `fetch_one_video_play_url` = `GET /tikhub/xigua/app/v2/fetch_one_video_play_url` (operationId: `get_tikhub_xigua_app_v2_fetch_one_video_play_url`).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "xigua fetch_one_video", "tags": [ "tikhub.xigua" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "3d2a2d39f76b" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/xigua/app/v2/fetch_one_video", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_xigua_app_v2_fetch_one_video", "method": "GET", "path": "/apis/v1/tikhub/xigua/app/v2/fetch_one_video" }, "parameters": [ { "name": "item_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Video id", "title": "Item Id" }, "description": "Video id", "example": "7354954305222377999" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:a728d8f5b042cff360c73126c6134e7d13140ab61e0260ec33038119103dc864" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/xigua/app/v2/fetch_one_video?item_id=7354954305222377999' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-xigua-app-v2-fetch_one_video" } }, "/apis/v1/tikhub/xigua/app/v2/fetch_one_video_play_url": { "get": { "description": "Xigua (app/v2).\n\n### Purpose:\n- Get single video play URL, the interface returns the decoded play URL, which can be used directly.\n### Parameters:\n- item_id: Video id\n### Return:\n- Play URL of the video, plaintext link.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_xigua_app_v2_fetch_one_video_play_url", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Play URL of the video, plaintext link.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "xigua fetch_one_video_play_url", "tags": [ "tikhub.xigua" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "852470ee51d8" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/xigua/app/v2/fetch_one_video_play_url", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_xigua_app_v2_fetch_one_video_play_url", "method": "GET", "path": "/apis/v1/tikhub/xigua/app/v2/fetch_one_video_play_url" }, "parameters": [ { "name": "item_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Video id", "title": "Item Id" }, "description": "Video id", "example": "7354954305222377999" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:d6d18d8b6267e384dbaaf14e03586b2151c5d037c22973f587ff649aeb8d6914" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/xigua/app/v2/fetch_one_video_play_url?item_id=7354954305222377999' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-xigua-app-v2-fetch_one_video_play_url" } }, "/apis/v1/tikhub/xigua/app/v2/fetch_user_info": { "get": { "description": "Xigua (app/v2).\n\n### Purpose:\n- Personal information\n### Parameters:\n- user_id: User id\n### Return:\n- Personal information\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_xigua_app_v2_fetch_user_info", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Personal information", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "xigua fetch_user_info", "tags": [ "tikhub.xigua" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "788c7d7207a6" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/xigua/app/v2/fetch_user_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_xigua_app_v2_fetch_user_info", "method": "GET", "path": "/apis/v1/tikhub/xigua/app/v2/fetch_user_info" }, "parameters": [ { "name": "user_id", "in": "query", "required": true, "schema": { "type": "string", "description": "User id", "title": "User Id" }, "description": "User id", "example": "52712347586" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:3bf496e47e31dca7f8ee6f4605b918d9af9d1e56abb18f95bb745126cac8eff7" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/xigua/app/v2/fetch_user_info?user_id=52712347586' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-xigua-app-v2-fetch_user_info" } }, "/apis/v1/tikhub/xigua/app/v2/fetch_user_post_list": { "get": { "description": "Xigua (app/v2).\n\n### Purpose:\n- Get user post list\n### Parameters:\n- user_id: User id\n- max_behot_time: Maximum behavior time, default empty, pass empty for the first request, pass the max_behot_time returned by the previous request for subsequent requests\n- The value of max_behot_time can be the JSON path: $.data.data.[-1].behot_time\n- That is, the cursor value of the last element in data\n### Return:\n- Post list\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_xigua_app_v2_fetch_user_post_list", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Post list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "xigua fetch_user_post_list", "tags": [ "tikhub.xigua" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "ab6a837a548f" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/xigua/app/v2/fetch_user_post_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_xigua_app_v2_fetch_user_post_list", "method": "GET", "path": "/apis/v1/tikhub/xigua/app/v2/fetch_user_post_list" }, "parameters": [ { "name": "max_behot_time", "in": "query", "required": false, "schema": { "type": "string", "description": "Maximum behavior time, default empty, pass empty for the first request, pass the max_behot_time returned by the previous request for subsequent requests", "title": "Max Behot Time" }, "description": "Maximum behavior time, default empty, pass empty for the first request, pass the max_behot_time returned by the previous request for subsequent requests" }, { "name": "user_id", "in": "query", "required": true, "schema": { "type": "string", "description": "User id", "title": "User Id" }, "description": "User id", "example": "1922379661976311" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:91a1ca2ece42a16a4dc9d3fddc43a8ed14ae8f9e22bee158f226132f909a368d" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/xigua/app/v2/fetch_user_post_list?user_id=1922379661976311' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-xigua-app-v2-fetch_user_post_list" } }, "/apis/v1/tikhub/xigua/app/v2/fetch_video_comment_list": { "get": { "description": "Xigua (app/v2).\n\n### Purpose:\n- Video comment list\n### Parameters:\n- item_id: Video id\n- offset: Offset, pass 0 for the first request, pass the offset returned by the previous request for subsequent requests\n- count: Quantity, default 20, it is recommended to keep the default.\n### Return:\n- Comment list\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_xigua_app_v2_fetch_video_comment_list", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Comment list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "xigua fetch_video_comment_list", "tags": [ "tikhub.xigua" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a25ce1d20e4d" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/xigua/app/v2/fetch_video_comment_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_xigua_app_v2_fetch_video_comment_list", "method": "GET", "path": "/apis/v1/tikhub/xigua/app/v2/fetch_video_comment_list" }, "parameters": [ { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "description": "Count\n\nUsage: Quantity, default 20, it is recommended to keep the default.", "default": 20, "title": "Count" }, "description": "Count\n\nUsage: Quantity, default 20, it is recommended to keep the default." }, { "name": "item_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Video id", "title": "Item Id" }, "description": "Video id", "example": "7354954305222377999" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "description": "Offset, pass 0 for the first request, pass the offset returned by the previous request for subsequent requests", "default": 0, "title": "Offset" }, "description": "Offset, pass 0 for the first request, pass the offset returned by the previous request for subsequent requests" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:962042ab31520ad47812c75e1610f6b2607494f0d51602f751aa63bf046f5eff" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/xigua/app/v2/fetch_video_comment_list?item_id=7354954305222377999' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-xigua-app-v2-fetch_video_comment_list" } }, "/apis/v1/tikhub/xigua/app/v2/search_video": { "get": { "description": "Xigua (app/v2).\n\n### Purpose:\n- Search video\n### Parameters:\n- keyword: Keyword\n- offset: Offset, pass 0 for the first request, pass the offset returned by the previous request for subsequent requests\n- order_type: Order type, empty for default sorting, the following are optional sorting methods.\n - Newest: publish_time\n - Hottest: play_count\n- min_duration: Minimum duration, default empty, in seconds.\n- max_duration: Maximum duration, default empty, in seconds.\n### Return:\n- Video list\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_xigua_app_v2_search_video", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Return\n- Video list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "xigua search_video", "tags": [ "tikhub.xigua" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "app", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "cf11489cbdc3" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/xigua/app/v2/search_video", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_xigua_app_v2_search_video", "method": "GET", "path": "/apis/v1/tikhub/xigua/app/v2/search_video" }, "parameters": [ { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Keyword", "title": "Keyword" }, "description": "Keyword", "example": "Douyin" }, { "name": "max_duration", "in": "query", "required": false, "schema": { "type": "integer", "description": "Maximum duration, default empty, in seconds.", "title": "Max Duration" }, "description": "Maximum duration, default empty, in seconds." }, { "name": "min_duration", "in": "query", "required": false, "schema": { "type": "integer", "description": "Minimum duration, default empty, in seconds.", "title": "Min Duration" }, "description": "Minimum duration, default empty, in seconds." }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "description": "Offset, pass 0 for the first request, pass the offset returned by the previous request for subsequent requests", "default": 0, "title": "Offset" }, "description": "Offset, pass 0 for the first request, pass the offset returned by the previous request for subsequent requests" }, { "name": "order_type", "in": "query", "required": false, "schema": { "type": "string", "description": "Order type, empty for default sorting, the following are optional sorting methods.\n - Newest: publish_time\n - Hottest: play_count", "title": "Order Type" }, "description": "Order type, empty for default sorting, the following are optional sorting methods.\n - Newest: publish_time\n - Hottest: play_count" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:b8e73d36c678eb43ca28370b20159a186daa49a5dd1301d3a177f619c5ff61d7" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/xigua/app/v2/search_video?keyword=Douyin' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-xigua-app-v2-search_video" } }, "/apis/v1/tikhub/youtube/web/get_channel_info": { "get": { "description": "YouTube (web).\n\n### Purpose:\n- Get channel information.\n### Parameters:\n- channel_id: Channel ID.\n### Returns:\n- Channel information.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_youtube_web_get_channel_info", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- Channel information.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "youtube get_channel_info", "tags": [ "tikhub.youtube" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "69bdde66d781" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/youtube/web/get_channel_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_youtube_web_get_channel_info", "method": "GET", "path": "/apis/v1/tikhub/youtube/web/get_channel_info" }, "parameters": [ { "name": "channel_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Channel ID", "title": "Channel Id" }, "description": "Channel ID", "example": "UCXuqSBlHAE6Xw-yeJA0Tunw" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:1a9c5f1f21dabd04ec0655272c2b38ec8a8ade2701b0a887705c7a6bb6b22d8d" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/youtube/web/get_channel_info?channel_id=UCXuqSBlHAE6Xw-yeJA0Tunw' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-youtube-web-get_channel_info" } }, "/apis/v1/tikhub/youtube/web/get_channel_short_videos": { "get": { "description": "YouTube (web).\n\n### Purpose:\n- Get channel short videos.\n### Parameters:\n- channel_id: Channel ID.\n- continuation_token: Token to continue fetching channel short videos. Default is None.\n### Returns:\n- Channel short videos.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_youtube_web_get_channel_short_videos", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- Channel short videos.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "youtube get_channel_short_videos", "tags": [ "tikhub.youtube" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "45ea92318eab" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/youtube/web/get_channel_short_videos", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_youtube_web_get_channel_short_videos", "method": "GET", "path": "/apis/v1/tikhub/youtube/web/get_channel_short_videos" }, "parameters": [ { "name": "channel_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Channel ID", "title": "Channel Id" }, "description": "Channel ID", "example": "UCXuqSBlHAE6Xw-yeJA0Tunw" }, { "name": "continuation_token", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination token\n\nUsage: Token to continue fetching channel short videos. Default is None.", "title": "Continuation Token" }, "description": "Pagination token\n\nUsage: Token to continue fetching channel short videos. Default is None." } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:df7628f4ec01db93b65d2627b2ab59bdfb1b7781ac2994d1c86170239042c20c" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/youtube/web/get_channel_short_videos?channel_id=UCXuqSBlHAE6Xw-yeJA0Tunw' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-youtube-web-get_channel_short_videos" } }, "/apis/v1/tikhub/youtube/web/get_channel_url": { "get": { "description": "YouTube (web).\n\n### Purpose:\n- Convert YouTube channel ID to channel handle (@username)\n- Reverse operation of get_channel_id_v2 endpoint\n\n### Parameters:\n- channel_id: Channel ID (e.g., UCeu6U67OzJhV1KwBansH3Dg)\n\n### Returns:\n- channel_id: Channel ID\n- handle: Channel handle (e.g., CozyCraftYT)\n- title: Channel name\n- channel_url: Standard channel URL (/channel/ format)\n- vanity_url: Vanity URL (/@username format)\n\n### Use Cases:\n- When you have channel ID but need @username format URL\n- When you need to display user-friendly channel links\n\nUpstream-only reference: `get_channel_id_v2` is `GET /api/v1/youtube/web/get_channel_id_v2` in the official API. It is not exposed as an operation in this specification.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_youtube_web_get_channel_url", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- channel_id: Channel ID\n- handle: Channel handle (e.g., CozyCraftYT)\n- title: Channel name\n- channel_url: Standard channel URL (/channel format)\n- vanity_url: Vanity URL (/@username format)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "youtube get_channel_url", "tags": [ "tikhub.youtube" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "8a7f024d0d29" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/youtube/web/get_channel_url", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_youtube_web_get_channel_url", "method": "GET", "path": "/apis/v1/tikhub/youtube/web/get_channel_url" }, "parameters": [ { "name": "channel_id", "in": "query", "required": true, "schema": { "type": "string", "description": "ID/Channel ID ( UCeu6U67OzJhV1KwBansH3Dg", "title": "Channel Id" }, "description": "ID/Channel ID ( UCeu6U67OzJhV1KwBansH3Dg", "example": "UCeu6U67OzJhV1KwBansH3Dg" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:c695a3e726293bf99e9b5a3b52fb9d4876d81bd89a348292e1eb9a676863c494" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/youtube/web/get_channel_url?channel_id=UCeu6U67OzJhV1KwBansH3Dg' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-youtube-web-get_channel_url" } }, "/apis/v1/tikhub/youtube/web/get_relate_video": { "get": { "description": "YouTube (web).\n\n### Purpose:\n- Get related videos by video ID.\n### Parameters:\n- video_id: Video ID, get it from the URL, for example: https://www.youtube.com/watch?v=LuIL5JATZsc, the id is LuIL5JATZsc.\n- continuation_token: Token to continue fetching related videos. Default is None.\n### Returns:\n- Related videos.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_youtube_web_get_relate_video", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- Related videos.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "youtube get_relate_video", "tags": [ "tikhub.youtube" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "f8cbc5cea4c5" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/youtube/web/get_relate_video", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_youtube_web_get_relate_video", "method": "GET", "path": "/apis/v1/tikhub/youtube/web/get_relate_video" }, "parameters": [ { "name": "continuation_token", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination token\n\nUsage: Token to continue fetching related videos. Default is None.", "title": "Continuation Token" }, "description": "Pagination token\n\nUsage: Token to continue fetching related videos. Default is None." }, { "name": "video_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Video ID, get it from the URL, for example: https://www.youtube.com/watch?v=LuIL5JATZsc, the id is LuIL5JATZsc.", "title": "Video Id" }, "description": "Video ID, get it from the URL, for example: https://www.youtube.com/watch?v=LuIL5JATZsc, the id is LuIL5JATZsc.", "example": "LuIL5JATZsc" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:ac89eccd4ec2b8823ed5b439e2f0f8615659623e393164c8d0e57ef0b27de4e7" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/youtube/web/get_relate_video?video_id=LuIL5JATZsc' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-youtube-web-get_relate_video" } }, "/apis/v1/tikhub/youtube/web/get_trending_videos": { "get": { "description": "Get trending videos\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_youtube_web_get_trending_videos", "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "youtube get_trending_videos", "tags": [ "tikhub.youtube" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "56574ca484fc" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/youtube/web/get_trending_videos", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_youtube_web_get_trending_videos", "method": "GET", "path": "/apis/v1/tikhub/youtube/web/get_trending_videos" }, "parameters": [ { "name": "country_code", "in": "query", "required": false, "schema": { "type": "string", "description": "Country code", "default": "us", "title": "Country Code" }, "description": "Country code" }, { "name": "language_code", "in": "query", "required": false, "schema": { "type": "string", "description": "Language code", "default": "en", "title": "Language Code" }, "description": "Language code" }, { "name": "section", "in": "query", "required": false, "schema": { "type": "string", "description": "Section", "default": "Now", "title": "Section" }, "description": "Section" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-pending": { "operation_id": "get_tikhub_youtube_web_get_trending_videos", "path": "/apis/v1/tikhub/youtube/web/get_trending_videos", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-youtube-web-get_trending_videos" } }, "/apis/v1/tikhub/youtube/web/search_channel": { "get": { "description": "YouTube (web).\n\n### Purpose:\n- Search channel.\n### Parameters:\n- search_query: Search keyword.\n- language_code: Language code, default is en.\n- country_code: Country code, default is us.\n- continuation_token: Token to continue fetching search results. Default is None.\n### Returns:\n- Search results.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_youtube_web_search_channel", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- Search results.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "youtube search_channel", "tags": [ "tikhub.youtube" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "5d8213c76313" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/youtube/web/search_channel", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_youtube_web_search_channel", "method": "GET", "path": "/apis/v1/tikhub/youtube/web/search_channel" }, "parameters": [ { "name": "channel_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Channel ID", "title": "Channel Id" }, "description": "Channel ID", "example": "UCXuqSBlHAE6Xw-yeJA0Tunw" }, { "name": "continuation_token", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination token\n\nUsage: Token to continue fetching search results. Default is None.", "title": "Continuation Token" }, "description": "Pagination token\n\nUsage: Token to continue fetching search results. Default is None." }, { "name": "country_code", "in": "query", "required": false, "schema": { "type": "string", "description": "Country code", "default": "us", "title": "Country Code" }, "description": "Country code" }, { "name": "language_code", "in": "query", "required": false, "schema": { "type": "string", "description": "Language code", "default": "en", "title": "Language Code" }, "description": "Language code" }, { "name": "search_query", "in": "query", "required": true, "schema": { "type": "string", "description": "Search keyword", "title": "Search Query" }, "description": "Search keyword", "example": "AMD" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:089a5ed891df6b8a1552b2206903db39001495d5863e721dcde6757c14a33676" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/youtube/web/search_channel?channel_id=UCXuqSBlHAE6Xw-yeJA0Tunw&search_query=AMD' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-youtube-web-search_channel" } }, "/apis/v1/tikhub/youtube/web/search_video": { "get": { "description": "YouTube (web).\n\n### Purpose:\n- Search video.\n### Parameters:\n- search_query: Search keyword.\n- language_code: Language code, default is en.\n- order_by: Order by, default is this_month, optional values are this_week, this_month, this_year, last_hour, today.\n- country_code: Country code, default is us.\n- continuation_token: Token to continue fetching search results. Default is None.\n### Returns:\n- Search results.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_youtube_web_search_video", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- Search results.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "youtube search_video", "tags": [ "tikhub.youtube" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "f7a281e47712" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/youtube/web/search_video", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_youtube_web_search_video", "method": "GET", "path": "/apis/v1/tikhub/youtube/web/search_video" }, "parameters": [ { "name": "continuation_token", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination token\n\nUsage: Token to continue fetching search results. Default is None.", "title": "Continuation Token" }, "description": "Pagination token\n\nUsage: Token to continue fetching search results. Default is None." }, { "name": "country_code", "in": "query", "required": false, "schema": { "type": "string", "description": "Country code", "default": "us", "title": "Country Code" }, "description": "Country code" }, { "name": "language_code", "in": "query", "required": false, "schema": { "type": "string", "description": "Language code", "default": "en", "title": "Language Code" }, "description": "Language code" }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "description": "Order by, default is this_month, optional values are this_week, this_month, this_year, last_hour, today.", "default": "this_month", "title": "Order By" }, "description": "Order by, default is this_month, optional values are this_week, this_month, this_year, last_hour, today." }, { "name": "search_query", "in": "query", "required": true, "schema": { "type": "string", "description": "Search keyword", "title": "Search Query" }, "description": "Search keyword", "example": "Minecraft" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:089a5ed891df6b8a1552b2206903db39001495d5863e721dcde6757c14a33676" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/youtube/web/search_video?search_query=Minecraft' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-youtube-web-search_video" } }, "/apis/v1/tikhub/youtube/web_v2/get_channel_community_posts": { "get": { "description": "YouTube (web_v2).\n\n### Purpose\n- Get YouTube channel's community posts list\n- Supports pagination via continuation_token\n\n### Parameters\n#### Required:\n**channel_id** (string)\n- **Purpose**: Channel ID\n- **How to get**: Extract from channel URL, e.g., `https://www.youtube.com/channel/UCkRfArvrzheW2E7b6SVT7vQ`\n- **Example**: `\"UCkRfArvrzheW2E7b6SVT7vQ\"`\n\n#### Optional:\n**language_code** (string, optional) - Language code, default `\"zh-CN\"`\n\n**country_code** (string, optional) - Country code, default `\"US\"`\n\n**continuation_token** (string, optional) - Pagination token for next page\n\n**need_format** (bool, optional) - Whether to format data, default `true`\n\n### Returns\n#### When need_format=true:\n- channel_id: Channel ID\n- posts: Posts list\n - post_id: Post ID\n - post_url: Post URL\n - author_name: Author name\n - author_channel_id: Author channel ID\n - author_url: Author channel URL\n - author_thumbnails: Author avatar thumbnails\n - content_text: Post text content\n - published_time: Published time (relative)\n - vote_count: Like count\n - comment_count: Comment count\n - attachment: Attachment (image/multi_image/video/poll, may be null)\n- continuation_token: Next page pagination token\n- has_more: Whether there are more posts\n- total_count: Current page post count\n\n#### When need_format=false:\n- Returns raw response data\n\n### Usage Flow\n1. First request: Only pass channel_id parameter\n2. Get continuation_token from response\n3. Next request: Pass channel_id and continuation_token\n4. Repeat steps 2-3 until has_more is false\n\n### Notes\n- Each page typically returns around 20 posts\n- Post attachments support: image, multi_image, video, poll types\n- Some channels may not have posts/community tab\n\n### Example\n#### Get channel posts: channel_id = \"UCkRfArvrzheW2E7b6SVT7vQ\"\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_youtube_web_v2_get_channel_community_posts", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n#### When need_format=true:\n- channel_id: Channel ID\n- posts: Posts list\n - post_id: Post ID\n - post_url: Post URL\n - author_name: Author name\n - author_channel_id: Author channel ID\n - author_url: Author channel URL\n - author_thumbnails: Author avatar thumbnails\n - content_text: Post text content\n - published_time: Published time (relative)\n - vote_count: Like count\n - comment_count: Comment count\n - attachment: Attachment (image/multi_image/video/poll, may be null)\n- continuation_token: Next page pagination token\n- has_more: Whether there are more posts\n- total_count: Current page post count\n\n#### When need_format=false:\n- Returns raw response data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "youtube get_channel_community_posts", "tags": [ "tikhub.youtube" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web_v2", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "6f34d94cddb1" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/youtube/web_v2/get_channel_community_posts", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_youtube_web_v2_get_channel_community_posts", "method": "GET", "path": "/apis/v1/tikhub/youtube/web_v2/get_channel_community_posts" }, "parameters": [ { "name": "channel_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Channel ID", "title": "Channel Id" }, "description": "Channel ID", "example": "UCkRfArvrzheW2E7b6SVT7vQ" }, { "name": "continuation_token", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination token for next page", "title": "Continuation Token" }, "description": "Pagination token for next page" }, { "name": "country_code", "in": "query", "required": false, "schema": { "type": "string", "description": "Country code", "default": "US", "title": "Country Code" }, "description": "Country code", "example": "US" }, { "name": "language_code", "in": "query", "required": false, "schema": { "type": "string", "description": "Language code", "default": "zh-CN", "title": "Language Code" }, "description": "Language code", "example": "zh-CN" }, { "name": "need_format", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether to clean and format the data", "default": true, "title": "Need Format" }, "description": "Whether to clean and format the data" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:9ac76c6e82a4a3f17f1c493e629bd3e14e294cf5b3b088d4dff9450c3fc244a1" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/youtube/web_v2/get_channel_community_posts?channel_id=UCkRfArvrzheW2E7b6SVT7vQ&country_code=US&language_code=zh-CN' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-youtube-web_v2-get_channel_community_posts" } }, "/apis/v1/tikhub/youtube/web_v2/get_channel_description": { "get": { "description": "YouTube (web_v2).\n\n### Purpose:\n- Get YouTube channel description information (subscribers, videos, views, creation date, social links, etc.)\n\n### Important - Two requests required for complete data:\n- **First request** (with channel_id): Returns basic info (title, description, subscribers, videos, avatar, banner, etc.)\n- **Second request** (with continuation_token): Returns advanced info (**creation date, social media links, country, view count**, etc.)\n\n### How to get channel_id:\n- If you only have channel URL (e.g., `https://www.youtube.com/@CozyCraftYT`), call **get_channel_id** endpoint first\n- It will return channel_id like `UCeu6U67OzJhV1KwBansH3Dg`\n\n### Parameters:\n\n#### 📌 Required (choose one):\n**channel_id** (string)\n- **Purpose**: Channel ID for first request to get basic channel info\n- **Format**: Usually starts with `UC`, 24 characters\n- **Example**: `\"UCeu6U67OzJhV1KwBansH3Dg\"`\n- **How to get**: Call **get_channel_id** endpoint with channel URL\n\n**continuation_token** (string)\n- **Purpose**: Pagination token for second request to get advanced info\n- **How to get**: Get `continuation_token` field from first request response\n- **Note**: Must provide either `channel_id` or `continuation_token`\n\n#### ⚙️ Optional:\n**language_code** (string, optional)\n- **Purpose**: Set language preference\n- **Default**: `\"zh-CN\"`\n- **Values**: `\"zh-CN\"`, `\"en-US\"`, `\"ja-JP\"`, `\"ko-KR\"`, etc.\n\n**country_code** (string, optional)\n- **Purpose**: Set region code\n- **Default**: `\"US\"`\n- **Values**: `\"US\"`, `\"JP\"`, `\"GB\"`, etc.\n\n**need_format** (boolean, optional)\n- **Purpose**: Whether to return cleaned simplified data\n- **Default**: `true`\n- **Values**:\n - `false` - Return raw complete data\n - `true` - Return cleaned simplified data (recommended, default)\n\n### Usage Flow (3 steps for complete data):\n1. **Get channel_id**: If you only have URL, call `get_channel_id?channel_url=https://www.youtube.com/@CozyCraftYT`\n2. **First request**: Use `channel_id` parameter to get basic info and `continuation_token`\n3. **Second request**: Use `continuation_token` to get advanced info (creation date, social links, etc.)\n\n### Response Structure (need_format=true):\n\n#### First request response (with channel_id):\n```json\n{\n \"channel_id\": \"UCeu6U67OzJhV1KwBansH3Dg\",\n \"title\": \"CozyCraft\",\n \"handle\": \"CozyCraftYT\",\n \"description\": \"Channel description...\",\n \"subscriber_count\": \"98.4K subscribers\",\n \"video_count\": \"181 videos\",\n \"view_count\": null,\n \"country\": null,\n \"creation_date\": null,\n \"links\": [],\n \"avatar\": [{\"url\": \"...\", \"width\": 900, \"height\": 900}],\n \"banner\": [{\"url\": \"...\", \"width\": 2560, \"height\": 424}],\n \"keywords\": \"Minecraft Ambience...\",\n \"channel_url\": \"https://www.youtube.com/channel/UCeu6U67OzJhV1KwBansH3Dg\",\n \"vanity_url\": \"http://www.youtube.com/@CozyCraftYT\",\n \"rss_url\": \"https://www.youtube.com/feeds/videos.xml?channel_id=UCeu6U67OzJhV1KwBansH3Dg\",\n \"is_family_safe\": true,\n \"verified\": false,\n \"has_business_email\": false,\n \"has_membership\": true,\n \"continuation_token\": \"4qmFsgJg...\"\n}\n```\n\n#### Second request response (with continuation_token):\n```json\n{\n \"channel_id\": \"UCeu6U67OzJhV1KwBansH3Dg\",\n \"title\": null,\n \"handle\": \"CozyCraftYT\",\n \"description\": \"Full channel description...\",\n \"subscriber_count\": \"98.4K subscribers\",\n \"video_count\": \"181 videos\",\n \"view_count\": \"53,218,926 views\",\n \"country\": \"United States\",\n \"creation_date\": \"Oct 28, 2022\",\n \"links\": [\n {\"name\": \"Discord\", \"url\": \"https://discord.gg/tvuxxcsgSS\"},\n {\"name\": \"Twitter\", \"url\": \"https://twitter.com/...\"}\n ],\n \"avatar\": [],\n \"banner\": [],\n \"verified\": false,\n \"has_business_email\": true,\n \"continuation_token\": null\n}\n```\n\n### Notes:\n- **Two requests are required to get complete channel information**\n- First request: Get basic info (title, avatar, banner, keywords, rss_url, etc.) and continuation_token\n- Second request: Get advanced info (creation_date, links, view_count, country, etc.)\n- Recommend setting `need_format=true` for both requests\n- You can merge results from both requests for complete channel info\n\nAPI references: `get_channel_id` = `GET /tikhub/youtube/web_v2/get_channel_id` (operationId: `get_tikhub_youtube_web_v2_get_channel_id`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_youtube_web_v2_get_channel_description", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Response Structure (need_format=true)\n#### First request response (with channel_id):\n```json\n{\n \"channel_id\": \"UCeu6U67OzJhV1KwBansH3Dg\",\n \"title\": \"CozyCraft\",\n \"handle\": \"CozyCraftYT\",\n \"description\": \"Channel description...\",\n \"subscriber_count\": \"98.4K subscribers\",\n \"video_count\": \"181 videos\",\n \"view_count\": null,\n \"country\": null,\n \"creation_date\": null,\n \"links\": [],\n \"avatar\": [{\"url\": \"...\", \"width\": 900, \"height\": 900}],\n \"banner\": [{\"url\": \"...\", \"width\": 2560, \"height\": 424}],\n \"keywords\": \"Minecraft Ambience...\",\n \"channel_url\": \"https://www.youtube.com/channel/UCeu6U67OzJhV1KwBansH3Dg\",\n \"vanity_url\": \"http://www.youtube.com/@CozyCraftYT\",\n \"rss_url\": \"https://www.youtube.com/feeds/videos.xml?channel_id=UCeu6U67OzJhV1KwBansH3Dg\",\n \"is_family_safe\": true,\n \"verified\": false,\n \"has_business_email\": false,\n \"has_membership\": true,\n \"continuation_token\": \"4qmFsgJg...\"\n}\n```\n\n#### Second request response (with continuation_token):\n```json\n{\n \"channel_id\": \"UCeu6U67OzJhV1KwBansH3Dg\",\n \"title\": null,\n \"handle\": \"CozyCraftYT\",\n \"description\": \"Full channel description...\",\n \"subscriber_count\": \"98.4K subscribers\",\n \"video_count\": \"181 videos\",\n \"view_count\": \"53,218,926 views\",\n \"country\": \"United States\",\n \"creation_date\": \"Oct 28, 2022\",\n \"links\": [\n {\"name\": \"Discord\", \"url\": \"https://discord.gg/tvuxxcsgSS\"},\n {\"name\": \"Twitter\", \"url\": \"https://twitter.com/...\"}\n ],\n \"avatar\": [],\n \"banner\": [],\n \"verified\": false,\n \"has_business_email\": true,\n \"continuation_token\": null\n}\n```", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "youtube get_channel_description", "tags": [ "tikhub.youtube" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web_v2", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "469da61c2430" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/youtube/web_v2/get_channel_description", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_youtube_web_v2_get_channel_description", "method": "GET", "path": "/apis/v1/tikhub/youtube/web_v2/get_channel_description" }, "parameters": [ { "name": "channel_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Channel ID, can be obtained from channel URL via get_channel_id endpoint\n\nAPI references: `get_channel_id` = `GET /tikhub/youtube/web_v2/get_channel_id` (operationId: `get_tikhub_youtube_web_v2_get_channel_id`).", "title": "Channel Id" }, "description": "Channel ID, can be obtained from channel URL via get_channel_id endpoint\n\nAPI references: `get_channel_id` = `GET /tikhub/youtube/web_v2/get_channel_id` (operationId: `get_tikhub_youtube_web_v2_get_channel_id`).", "example": "UCeu6U67OzJhV1KwBansH3Dg" }, { "name": "continuation_token", "in": "query", "required": false, "schema": { "type": "string", "description": "Continuation token for getting advanced info like channel creation date", "title": "Continuation Token" }, "description": "Continuation token for getting advanced info like channel creation date" }, { "name": "country_code", "in": "query", "required": false, "schema": { "type": "string", "description": "Country code", "default": "US", "title": "Country Code" }, "description": "Country code", "example": "US" }, { "name": "language_code", "in": "query", "required": false, "schema": { "type": "string", "description": "Language code", "default": "zh-CN", "title": "Language Code" }, "description": "Language code", "example": "zh-CN" }, { "name": "need_format", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether to clean and format the data", "default": true, "title": "Need Format" }, "description": "Whether to clean and format the data" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:07608580776ecb873630df3b8f4f11fc418642100248c69ec787fe9d27329c12" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-youtube-web_v2-get_channel_description" } }, "/apis/v1/tikhub/youtube/web_v2/get_channel_id": { "get": { "description": "YouTube (web_v2).\n\n### Purpose:\n- Convert YouTube channel URL to channel ID.\n- Supports multiple URL formats including @username, /channel/, /c/, /user/ formats.\n### Parameters:\n- channel_url: Channel URL.\n### Returns:\n- channel_id: Channel ID (e.g., UCeu6U67OzJhV1KwBansH3Dg)\n- channel_url: Normalized channel URL\n- source: Data source (url_parse means parsed from URL directly, page_parse means parsed from page)\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_youtube_web_v2_get_channel_id", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- channel_id: Channel ID (e.g., UCeu6U67OzJhV1KwBansH3Dg)\n- channel_url: Normalized channel URL\n- source: Data source (url_parse means parsed from URL directly, page_parse means parsed from page)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "youtube get_channel_id", "tags": [ "tikhub.youtube" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web_v2", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "4004bcac9a71" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/youtube/web_v2/get_channel_id", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_youtube_web_v2_get_channel_id", "method": "GET", "path": "/apis/v1/tikhub/youtube/web_v2/get_channel_id" }, "parameters": [ { "name": "channel_url", "in": "query", "required": true, "schema": { "type": "string", "description": "channelname", "title": "Channel Url" }, "description": "channelname", "example": "https://www.youtube.com/@CozyCraftYT" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:a9269ce53312c023807f4565f7ed1201ac62f490d38f34b18327b708d5d151de" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/youtube/web_v2/get_channel_id?channel_url=https%3A%2F%2Fwww.youtube.com%2F%40CozyCraftYT' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-youtube-web_v2-get_channel_id" } }, "/apis/v1/tikhub/youtube/web_v2/get_channel_shorts": { "get": { "description": "YouTube (web_v2).\n\n### Purpose\n- Get YouTube channel's Shorts (short videos) list\n- Supports pagination to get more shorts\n\n### Parameters\n- channel_id: Channel ID (recommended, e.g., UCuAXFkgsw1L7xaCfnd5JJOw)\n- channel_url: Channel URL (optional, ignored if channel_id is provided)\n- continuation_token: Pagination token (optional, for next page)\n- need_format: Whether to format data (default true)\n - true: Return formatted structured data (recommended)\n - false: Return raw YouTube API structure (for debugging)\n\n### Returns\n#### When need_format=true:\n- channel_id: Channel ID\n- shorts: Shorts list\n - video_id: Short video ID\n - title: Title\n - view_count_text: View count text (e.g., \"1.2M views\")\n - thumbnails: Thumbnail list\n - accessibility_text: Accessibility description text\n - video_url: Short video URL\n- continuation_token: Next page pagination token\n- has_more: Whether there are more shorts\n- total_count: Current page shorts count\n\n#### When need_format=false:\n- channel_id: Channel ID\n- shorts: Raw reelItemRenderer object list\n- continuation_token: Next page pagination token\n- has_more: Whether there are more shorts\n- total_count: Current page shorts count\n\n### Usage Flow\n1. First request: Only pass channel_id parameter\n2. Get continuation_token from response\n3. Next request: Pass channel_id and continuation_token\n4. Repeat steps 2-3 until has_more is false\n\n### Notes\n- Each page typically returns around 30 shorts\n- ⚠️ Currently does not support @username format, please use channel ID (UCxxxx format)\n\n### Example\n#### Get Shorts: channel_id = \"UCuAXFkgsw1L7xaCfnd5JJOw\"\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_youtube_web_v2_get_channel_shorts", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n#### When need_format=true:\n- channel_id: Channel ID\n- shorts: Shorts list\n - video_id: Short video ID\n - title: Title\n - view_count_text: View count text (e.g., \"1.2M views\")\n - thumbnails: Thumbnail list\n - accessibility_text: Accessibility description text\n - video_url: Short video URL\n- continuation_token: Next page pagination token\n- has_more: Whether there are more shorts\n- total_count: Current page shorts count\n\n#### When need_format=false:\n- channel_id: Channel ID\n- shorts: Raw reelItemRenderer object list\n- continuation_token: Next page pagination token\n- has_more: Whether there are more shorts\n- total_count: Current page shorts count", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "youtube get_channel_shorts", "tags": [ "tikhub.youtube" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web_v2", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "35b62e3177ba" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/youtube/web_v2/get_channel_shorts", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_youtube_web_v2_get_channel_shorts", "method": "GET", "path": "/apis/v1/tikhub/youtube/web_v2/get_channel_shorts" }, "parameters": [ { "name": "channel_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Channel ID (e.g., UCuAXFkgsw1L7xaCfnd5JJOw", "title": "Channel Id" }, "description": "Channel ID (e.g., UCuAXFkgsw1L7xaCfnd5JJOw", "example": "UCuAXFkgsw1L7xaCfnd5JJOw" }, { "name": "channel_url", "in": "query", "required": false, "schema": { "type": "string", "description": "Ignored if channel_id is provided", "title": "Channel Url" }, "description": "Ignored if channel_id is provided", "example": "https://www.youtube.com/channel/UCuAXFkgsw1L7xaCfnd5JJOw" }, { "name": "continuation_token", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination token (optional, for next page)", "title": "Continuation Token" }, "description": "Pagination token (optional, for next page)" }, { "name": "need_format", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether to format data (default true)\n - true: Return formatted structured data (recommended)\n - false: Return raw YouTube API structure (for debugging)", "default": true, "title": "Need Format" }, "description": "Whether to format data (default true)\n - true: Return formatted structured data (recommended)\n - false: Return raw YouTube API structure (for debugging)" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:56ec68a22430f75d5feb3ad2d1efb10513ad736d7fda4d0d3e0edbc6f75d7c47" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-youtube-web_v2-get_channel_shorts" } }, "/apis/v1/tikhub/youtube/web_v2/get_channel_url": { "get": { "description": "YouTube (web_v2).\n\n### Purpose:\n- Convert YouTube channel ID to channel handle (@username)\n- Reverse operation of get_channel_id endpoint\n\n### Parameters:\n- channel_id: Channel ID (e.g., UCeu6U67OzJhV1KwBansH3Dg)\n\n### Returns:\n- channel_id: Channel ID\n- handle: Channel handle (e.g., CozyCraftYT)\n- title: Channel name\n- channel_url: Standard channel URL (/channel/ format)\n- vanity_url: Vanity URL (/@username format)\n\n### Use Cases:\n- When you have channel ID but need @username format URL\n- When you need to display user-friendly channel links\n\nAPI references: `get_channel_id` = `GET /tikhub/youtube/web_v2/get_channel_id` (operationId: `get_tikhub_youtube_web_v2_get_channel_id`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_youtube_web_v2_get_channel_url", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- channel_id: Channel ID\n- handle: Channel handle (e.g., CozyCraftYT)\n- title: Channel name\n- channel_url: Standard channel URL (/channel format)\n- vanity_url: Vanity URL (/@username format)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "youtube get_channel_url", "tags": [ "tikhub.youtube" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web_v2", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "c9a4e9b71f7e" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/youtube/web_v2/get_channel_url", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_youtube_web_v2_get_channel_url", "method": "GET", "path": "/apis/v1/tikhub/youtube/web_v2/get_channel_url" }, "parameters": [ { "name": "channel_id", "in": "query", "required": true, "schema": { "type": "string", "description": "ID/Channel ID ( UCeu6U67OzJhV1KwBansH3Dg", "title": "Channel Id" }, "description": "ID/Channel ID ( UCeu6U67OzJhV1KwBansH3Dg", "example": "UCeu6U67OzJhV1KwBansH3Dg" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:c695a3e726293bf99e9b5a3b52fb9d4876d81bd89a348292e1eb9a676863c494" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/youtube/web_v2/get_channel_url?channel_id=UCeu6U67OzJhV1KwBansH3Dg' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-youtube-web_v2-get_channel_url" } }, "/apis/v1/tikhub/youtube/web_v2/get_channel_videos": { "get": { "description": "YouTube (web_v2).\n\n### Purpose\n- Get YouTube channel video list\n- Supports pagination via continuation_token\n\n### Parameters\n#### 📌 Required:\n**channel_id** (string)\n- **Purpose**: Channel ID\n- **How to get**:\n - Extract from channel URL, e.g., `https://www.youtube.com/channel/UCJHBJ7F-nAIlMGolm0Hu4vg`\n - Or visit the channel page to get the real channel ID from `@username` format URLs\n- **Example**: `\"UCJHBJ7F-nAIlMGolm0Hu4vg\"`\n\n#### ⚙️ Optional:\n**language_code** (string, optional)\n- **Purpose**: Set language preference\n- **Default**: `\"zh-CN\"`\n- **Values**: `\"zh-CN\"`, `\"en-US\"`, `\"ja-JP\"`, `\"ko-KR\"`, etc.\n\n**country_code** (string, optional)\n- **Purpose**: Set region code\n- **Default**: `\"US\"`\n- **Values**: `\"US\"`, `\"JP\"`, `\"GB\"`, etc.\n\n**continuation_token** (string, optional)\n- **Purpose**: Pagination token for next page\n- **How to get**: Extract from previous response\n- **First request**: Omit or set to `null`\n\n**need_format** (boolean, optional)\n- **Purpose**: Whether to return cleaned simplified data\n- **Default**: `true`\n- **Values**:\n - `false` - Return raw complete data\n - `true` - Return cleaned simplified data (recommended, default)\n\n### Response Structure (need_format=true)\n```json\n{\n \"channel\": {\n \"id\": \"UCJHBJ7F-nAIlMGolm0Hu4vg\",\n \"name\": \"Maizen\",\n \"description\": \"Thank you very much for watching our videos...\",\n \"handle_url\": \"http://www.youtube.com/@maizenofficial\",\n \"avatar\": \"https://yt3.googleusercontent.com/...=s900-...\",\n \"url\": \"https://www.youtube.com/channel/UCJHBJ7F-nAIlMGolm0Hu4vg\",\n \"rss_url\": \"https://www.youtube.com/feeds/videos.xml?channel_id=...\",\n \"keywords\": \"Minecraft\",\n \"is_family_safe\": true,\n \"is_verified\": true\n },\n \"videos\": [\n {\n \"video_id\": \"zd3yCa1bJCM\",\n \"title\": \"Minecraft: DREAM! - Asleep Custom Map\",\n \"thumbnail\": \"https://i.ytimg.com/vi/zd3yCa1bJCM/hqdefault.jpg\",\n \"thumbnails\": [\n {\"url\": \"...\", \"width\": 168, \"height\": 94},\n {\"url\": \"...\", \"width\": 336, \"height\": 188}\n ],\n \"moving_thumbnail\": \"https://i.ytimg.com/an_webp/zd3yCa1bJCM/mqdefault_6s.webp?...\",\n \"duration\": \"16:57\",\n \"duration_accessibility\": \"16 minutes, 57 seconds\",\n \"view_count\": \"343,369 views\",\n \"short_view_count\": \"343K views\",\n \"published_time\": \"18 hours ago\",\n \"description\": \"\",\n \"is_live\": false,\n \"is_verified\": true,\n \"url\": \"https://www.youtube.com/watch?v=zd3yCa1bJCM\",\n \"playback_url\": \"https://rr5---sn-ogueln67.googlevideo.com/initplayback?...\"\n }\n ],\n \"continuation_token\": \"next page token\"\n}\n```\n\n### Cleaned Data Field Descriptions\n**`channel` (object, channel-level metadata, shared across the listing):**\n\n⚠️ **Only returned on the first request (when `continuation_token` is not provided).** Paginated responses do not include channel-level metadata from YouTube, so the `channel` field is **omitted** — cache the first-page value as the source of truth. Likewise, `videos[].is_verified` is always `false` on paginated responses (unreliable).\n\n- `id`: Channel ID (same as the `channel_id` query param)\n- `name`: Channel name\n- `description`: Channel bio (multi-line text, often contains contact info / social links / channel introduction)\n- `handle_url`: Channel handle URL (e.g., `http://www.youtube.com/@maizenofficial`)\n- `avatar`: Channel avatar URL (largest size, up to 900×900)\n- `url`: Channel home URL\n- `rss_url`: Channel RSS feed URL\n- `keywords`: Channel keywords\n- `is_family_safe`: Whether the channel is family-safe\n- `is_verified`: Whether the channel has a YouTube verified (blue check) badge\n\n**`videos[]` (list, per video):**\n- `video_id`: Video ID\n- `title`: Video title\n- `thumbnail`: Highest resolution thumbnail URL\n- `thumbnails`: List of all resolution thumbnails\n- `moving_thumbnail`: Moving thumbnail URL (webp format, hover preview)\n- `duration`: Video duration (e.g., \"16:57\")\n- `duration_accessibility`: Duration accessibility text (e.g., \"16 minutes, 57 seconds\")\n- `view_count`: Full view count (e.g., \"343,369 views\")\n- `short_view_count`: Short view count (e.g., \"343K views\". Note: under the lockup format this is identical to `view_count`; kept only for backward compatibility)\n- `published_time`: Published time (e.g., \"18 hours ago\")\n- `description`: ⚠️ Since 2026, YouTube's channel video listings (lockup format) no longer include per-video description snippets. This field is always `\"\"`. For the channel-wide bio use the top-level `channel.description`; for per-video descriptions call the video detail endpoint.\n- `is_live`: Whether it's a live stream\n- `is_verified`: Whether the channel is verified (same as top-level `channel.is_verified` in the channel-videos context)\n- `url`: Video playback page URL\n- `playback_url`: Video playback initialization URL (googlevideo.com)\n- `continuation_token`: Pagination token for next page\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_youtube_web_v2_get_channel_videos", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Response Structure (need_format=true)\n```json\n{\n \"channel\": {\n \"id\": \"UCJHBJ7F-nAIlMGolm0Hu4vg\",\n \"name\": \"Maizen\",\n \"description\": \"Thank you very much for watching our videos...\",\n \"handle_url\": \"http://www.youtube.com/@maizenofficial\",\n \"avatar\": \"https://yt3.googleusercontent.com/...=s900-...\",\n \"url\": \"https://www.youtube.com/channel/UCJHBJ7F-nAIlMGolm0Hu4vg\",\n \"rss_url\": \"https://www.youtube.com/feeds/videos.xml?channel_id=...\",\n \"keywords\": \"Minecraft\",\n \"is_family_safe\": true,\n \"is_verified\": true\n },\n \"videos\": [\n {\n \"video_id\": \"zd3yCa1bJCM\",\n \"title\": \"Minecraft: DREAM! - Asleep Custom Map\",\n \"thumbnail\": \"https://i.ytimg.com/vi/zd3yCa1bJCM/hqdefault.jpg\",\n \"thumbnails\": [\n {\"url\": \"...\", \"width\": 168, \"height\": 94},\n {\"url\": \"...\", \"width\": 336, \"height\": 188}\n ],\n \"moving_thumbnail\": \"https://i.ytimg.com/an_webp/zd3yCa1bJCM/mqdefault_6s.webp?...\",\n \"duration\": \"16:57\",\n \"duration_accessibility\": \"16 minutes, 57 seconds\",\n \"view_count\": \"343,369 views\",\n \"short_view_count\": \"343K views\",\n \"published_time\": \"18 hours ago\",\n \"description\": \"\",\n \"is_live\": false,\n \"is_verified\": true,\n \"url\": \"https://www.youtube.com/watch?v=zd3yCa1bJCM\",\n \"playback_url\": \"https://rr5---sn-ogueln67.googlevideo.com/initplayback?...\"\n }\n ],\n \"continuation_token\": \"next page token\"\n}\n```", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "youtube get_channel_videos", "tags": [ "tikhub.youtube" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web_v2", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "04d318e539b7" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/youtube/web_v2/get_channel_videos", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_youtube_web_v2_get_channel_videos", "method": "GET", "path": "/apis/v1/tikhub/youtube/web_v2/get_channel_videos" }, "parameters": [ { "name": "channel_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Channel ID", "title": "Channel Id" }, "description": "Channel ID", "example": "UCJHBJ7F-nAIlMGolm0Hu4vg" }, { "name": "continuation_token", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination token for next page", "title": "Continuation Token" }, "description": "Pagination token for next page" }, { "name": "country_code", "in": "query", "required": false, "schema": { "type": "string", "description": "Country code", "default": "US", "title": "Country Code" }, "description": "Country code", "example": "US" }, { "name": "language_code", "in": "query", "required": false, "schema": { "type": "string", "description": "Language code", "default": "zh-CN", "title": "Language Code" }, "description": "Language code", "example": "zh-CN" }, { "name": "need_format", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether to clean and format the data", "default": true, "title": "Need Format" }, "description": "Whether to clean and format the data" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:395203d0b7138b9a51de658b1fdd3991e01501b42de1d0de9a31e1356f0c3504" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/youtube/web_v2/get_channel_videos?channel_id=UCJHBJ7F-nAIlMGolm0Hu4vg&country_code=US&language_code=zh-CN' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-youtube-web_v2-get_channel_videos" } }, "/apis/v1/tikhub/youtube/web_v2/get_general_search": { "get": { "description": "YouTube (web_v2).\n\n### Purpose\n- YouTube comprehensive search with multiple filter options for precise result filtering\n\n### Parameters\n- **search_query**: Search keyword\n- **language_code**: Language code (zh-CN for Chinese, en-US for English)\n- **country_code**: Country code affecting regional relevance\n- **time_zone**: Time zone setting\n\n### Filter Options (select one value for each)\n#### Upload Time (upload_time):\n- `hour`: Uploaded in the past hour\n- `today`: Uploaded today\n- `week`: Uploaded this week\n- `month`: Uploaded this month\n- `year`: Uploaded this year\n\n#### Duration (duration):\n- `short`: Short videos (under 4 minutes)\n- `medium`: Medium length (4-20 minutes)\n- `long`: Long videos (over 20 minutes)\n\n#### Content Type (content_type):\n- `video`: Videos\n- `channel`: Channels\n- `playlist`: Playlists\n- `movie`: Movies\n\n#### Features (feature):\n- `hd`: High definition\n- `4k`: 4K videos\n- `subtitles`: With subtitles\n- `live`: Live streams\n- `creative_commons`: Creative Commons licensed\n- `360`: 360-degree videos\n- `vr180`: VR180 videos\n- `3d`: 3D videos\n- `hdr`: HDR videos\n- `location`: With location info\n- `purchased`: Purchased content\n\n#### Sort By (sort_by):\n- `relevance`: Relevance (default)\n- `upload_date`: Upload date\n- `view_count`: View count\n- `rating`: Rating\n\n### ⚠️ Recommend using V2 version\n- This endpoint returns raw YouTube data structure that requires manual parsing\n- This endpoint returns raw data. The structured V2 search variant described by the upstream is not exposed in this specification.\n\n### Returns\n- Filtered search results\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_youtube_web_v2_get_general_search", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- Filtered search results", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "youtube get_general_search", "tags": [ "tikhub.youtube" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web_v2", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "080751f61393" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/youtube/web_v2/get_general_search", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_youtube_web_v2_get_general_search", "method": "GET", "path": "/apis/v1/tikhub/youtube/web_v2/get_general_search" }, "parameters": [ { "name": "content_type", "in": "query", "required": false, "schema": { "description": "Content type filter", "title": "Content Type", "anyOf": [ { "description": "Content type filter", "title": "Content Type", "allOf": [ { "type": "string", "enum": [ "video", "channel", "playlist", "movie" ], "title": "YouTubeContentTypeAPI", "description": "YouTube - API" } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "description": "Content type filter", "examples": { "video": { "summary": "See API documentation", "value": "video" }, "channel": { "summary": "See API documentation", "value": "channel" }, "playlist": { "summary": "See API documentation", "value": "playlist" }, "movie": { "summary": "See API documentation", "value": "movie" } } }, { "name": "continuation_token", "in": "query", "required": false, "schema": { "description": "Pagination token", "title": "Continuation Token", "type": [ "string", "null" ] }, "description": "Pagination token" }, { "name": "country_code", "in": "query", "required": false, "schema": { "type": "string", "description": "Country code affecting regional relevance", "default": "US", "title": "Country Code" }, "description": "Country code affecting regional relevance" }, { "name": "duration", "in": "query", "required": false, "schema": { "description": "Duration filter", "title": "Duration", "anyOf": [ { "description": "Duration filter", "title": "Duration", "allOf": [ { "type": "string", "enum": [ "short", "medium", "long" ], "title": "YouTubeDurationAPI", "description": "YouTube - API" } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "description": "Duration filter", "examples": { "short": { "summary": "<4", "value": "short" }, "medium": { "summary": "4-20", "value": "medium" }, "long": { "summary": ">20", "value": "long" } } }, { "name": "feature", "in": "query", "required": false, "schema": { "description": "Feature filter", "title": "Feature", "anyOf": [ { "description": "Feature filter", "title": "Feature", "allOf": [ { "type": "string", "enum": [ "live", "4k", "hd", "subtitles", "creative_commons", "360", "vr180", "3d", "hdr", "location", "purchased" ], "title": "YouTubeFeatureAPI", "description": "YouTube - API" } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "description": "Feature filter", "examples": { "hd": { "summary": "See API documentation", "value": "hd" }, "4k": { "summary": "4K", "value": "4k" }, "subtitles": { "summary": "See API documentation", "value": "subtitles" }, "live": { "summary": "See API documentation", "value": "live" }, "creative_commons": { "summary": "See API documentation", "value": "creative_commons" }, "360": { "summary": "360", "value": "360" }, "vr180": { "summary": "VR180", "value": "vr180" }, "3d": { "summary": "3D", "value": "3d" }, "hdr": { "summary": "HDR", "value": "hdr" }, "location": { "summary": "See API documentation", "value": "location" }, "purchased": { "summary": "See API documentation", "value": "purchased" } } }, { "name": "language_code", "in": "query", "required": false, "schema": { "type": "string", "description": "Language code (zh-CN for Chinese, en-US for English)", "default": "zh-CN", "title": "Language Code" }, "description": "Language code (zh-CN for Chinese, en-US for English)" }, { "name": "search_query", "in": "query", "required": true, "schema": { "type": "string", "maxLength": 200, "description": "Search keyword", "title": "Search Query" }, "description": "Search keyword", "example": "Python" }, { "name": "sort_by", "in": "query", "required": false, "schema": { "description": "Sort by", "title": "Sort By", "anyOf": [ { "description": "Sort by", "title": "Sort By", "allOf": [ { "type": "string", "enum": [ "relevance", "upload_date", "view_count", "rating" ], "title": "YouTubeSearchSortAPI", "description": "YouTube - API" } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "description": "Sort by", "examples": { "relevance": { "summary": "See API documentation", "value": "relevance" }, "upload_date": { "summary": "See API documentation", "value": "upload_date" }, "view_count": { "summary": "See API documentation", "value": "view_count" }, "rating": { "summary": "See API documentation", "value": "rating" } } }, { "name": "time_zone", "in": "query", "required": false, "schema": { "type": "string", "description": "Time zone", "default": "America/Los_Angeles", "title": "Time Zone" }, "description": "Time zone" }, { "name": "upload_time", "in": "query", "required": false, "schema": { "description": "Upload time filter", "title": "Upload Time", "anyOf": [ { "description": "Upload time filter", "title": "Upload Time", "allOf": [ { "type": "string", "enum": [ "hour", "today", "week", "month", "year" ], "title": "YouTubeUploadTimeAPI", "description": "YouTube - API" } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "description": "Upload time filter", "examples": { "hour": { "summary": "1", "value": "hour" }, "today": { "summary": "See API documentation", "value": "today" }, "week": { "summary": "See API documentation", "value": "week" }, "month": { "summary": "See API documentation", "value": "month" }, "year": { "summary": "See API documentation", "value": "year" } } } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e04a59798e258ec39190fd893f39daded95f250ac37976128d33d54693d7d46b" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/youtube/web_v2/get_general_search?search_query=Python' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-youtube-web_v2-get_general_search" } }, "/apis/v1/tikhub/youtube/web_v2/get_post_comment_replies": { "get": { "description": "YouTube (web_v2).\n\n### Purpose\n- Get replies to a post comment (second-level comments)\n\n### Parameters\n#### Required:\n**continuation_token** (string)\n- **Purpose**: Reply continuation token\n- **How to get**: Extract `reply_continuation_token` from post comment response\n\n#### Optional:\n**language_code** (string, optional) - Language code, default `\"zh-CN\"`\n\n**country_code** (string, optional) - Country code, default `\"US\"`\n\n**need_format** (bool, optional) - Whether to format data, default `true`\n\n### Usage Flow\n1. Get post comments via `/tikhub/youtube/web_v2/get_post_comments`\n2. Extract `reply_continuation_token` from a comment with replies\n3. Pass it as `continuation_token` to this endpoint\n4. Use returned `continuation_token` for more replies\n\n### Returns (need_format=true)\n- comments: Reply comments list\n- continuation_token: Next page token (if more replies)\n\n### Example\n#### GET /tikhub/youtube/web_v2/get_post_comment_replies?continuation_token=xxx&need_format=true\n\nAPI references: `get_post_comments` = `GET /tikhub/youtube/web_v2/get_post_comments` (operationId: `get_tikhub_youtube_web_v2_get_post_comments`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_youtube_web_v2_get_post_comment_replies", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns (need_format=true)\n- comments: Reply comments list\n- continuation_token: Next page token (if more replies)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "youtube get_post_comment_replies", "tags": [ "tikhub.youtube" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web_v2", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "960aaa4701c1" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/youtube/web_v2/get_post_comment_replies", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_youtube_web_v2_get_post_comment_replies", "method": "GET", "path": "/apis/v1/tikhub/youtube/web_v2/get_post_comment_replies" }, "parameters": [ { "name": "continuation_token", "in": "query", "required": true, "schema": { "type": "string", "description": "Reply continuation token from post comment", "title": "Continuation Token" }, "description": "Reply continuation token from post comment" }, { "name": "country_code", "in": "query", "required": false, "schema": { "type": "string", "description": "Country code", "default": "US", "title": "Country Code" }, "description": "Country code", "example": "US" }, { "name": "language_code", "in": "query", "required": false, "schema": { "type": "string", "description": "Language code", "default": "zh-CN", "title": "Language Code" }, "description": "Language code", "example": "zh-CN" }, { "name": "need_format", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether to clean and format the data", "default": true, "title": "Need Format" }, "description": "Whether to clean and format the data" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:40f1acdebd335e3702c2e4367fbdc25eeb6c2fefd1d191938cc3e5de69ca4c5a" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-youtube-web_v2-get_post_comment_replies" } }, "/apis/v1/tikhub/youtube/web_v2/get_post_comments": { "get": { "description": "YouTube (web_v2).\n\n### Purpose\n- Get YouTube post (community post) comments\n- Supports pagination for more comments\n\n### Parameters\n#### Required (at least one):\n**post_id** (string) - Post ID, required for first request\n\n**continuation_token** (string) - Pagination token (from get_post_detail's comments_continuation_token or previous response)\n\n#### Optional:\n**language_code** (string, optional) - Language code, default `\"zh-CN\"`\n\n**country_code** (string, optional) - Country code, default `\"US\"`\n\n**need_format** (bool, optional) - Whether to format data, default `true`\n\n### Returns (need_format=true)\n- comments: Comments list\n - comment_id, content, published_time, like_count, reply_count\n - reply_continuation_token: Token for fetching replies\n - author: Author info (channel_id, display_name, avatar_url, etc.)\n- continuation_token: Next page token\n\n### Usage Flow\n1. First request: Pass post_id (or use comments_continuation_token from get_post_detail)\n2. Get continuation_token from response\n3. Next request: Pass continuation_token for more comments\n4. Use reply_continuation_token to get replies via get_post_comment_replies\n\n### Example\n#### Get post comments: post_id = \"UgkxiCSRfD6g7SPlWGPDa3vbP7aIsytXRkvy\"\n\nAPI references: `get_post_comment_replies` = `GET /tikhub/youtube/web_v2/get_post_comment_replies` (operationId: `get_tikhub_youtube_web_v2_get_post_comment_replies`); `get_post_detail` = `GET /tikhub/youtube/web_v2/get_post_detail` (operationId: `get_tikhub_youtube_web_v2_get_post_detail`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_youtube_web_v2_get_post_comments", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns (need_format=true)\n- comments: Comments list\n - comment_id, content, published_time, like_count, reply_count\n - reply_continuation_token: Token for fetching replies\n - author: Author info (channel_id, display_name, avatar_url, etc.)\n- continuation_token: Next page token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "youtube get_post_comments", "tags": [ "tikhub.youtube" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web_v2", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "b7cf5f96b4a9" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/youtube/web_v2/get_post_comments", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_youtube_web_v2_get_post_comments", "method": "GET", "path": "/apis/v1/tikhub/youtube/web_v2/get_post_comments" }, "parameters": [ { "name": "continuation_token", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination token For the initial comments request, use the post-detail response's `comments_continuation_token`; subsequent comments pages use the previous comments response's `continuation_token`. Call `GET /tikhub/youtube/web_v2/get_post_detail` (operationId: `get_tikhub_youtube_web_v2_get_post_detail`).", "title": "Continuation Token" }, "description": "Pagination token For the initial comments request, use the post-detail response's `comments_continuation_token`; subsequent comments pages use the previous comments response's `continuation_token`. Call `GET /tikhub/youtube/web_v2/get_post_detail` (operationId: `get_tikhub_youtube_web_v2_get_post_detail`)." }, { "name": "country_code", "in": "query", "required": false, "schema": { "type": "string", "description": "Country code", "default": "US", "title": "Country Code" }, "description": "Country code", "example": "US" }, { "name": "language_code", "in": "query", "required": false, "schema": { "type": "string", "description": "Language code", "default": "zh-CN", "title": "Language Code" }, "description": "Language code", "example": "zh-CN" }, { "name": "need_format", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether to clean and format the data", "default": true, "title": "Need Format" }, "description": "Whether to clean and format the data" }, { "name": "post_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Post ID (required for first request", "title": "Post Id" }, "description": "Post ID (required for first request", "example": "UgkxiCSRfD6g7SPlWGPDa3vbP7aIsytXRkvy" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:710c272fe879530881f372f1f44b1a0220f92dfa40bebfe9eeb36accf162b394" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-youtube-web_v2-get_post_comments" } }, "/apis/v1/tikhub/youtube/web_v2/get_post_detail": { "get": { "description": "YouTube (web_v2).\n\n### Purpose\n- Get YouTube post (community post) detail information\n- Includes post content, attachments, engagement data\n\n### Parameters\n#### Required:\n**post_id** (string)\n- **Purpose**: Post ID\n- **How to get**: Extract from post URL, e.g., `https://www.youtube.com/post/UgkxiCSRfD6g7SPlWGPDa3vbP7aIsytXRkvy`\n- **Example**: `\"UgkxiCSRfD6g7SPlWGPDa3vbP7aIsytXRkvy\"`\n\n#### Optional:\n**language_code** (string, optional) - Language code, default `\"zh-CN\"`\n\n**country_code** (string, optional) - Country code, default `\"US\"`\n\n**need_format** (bool, optional) - Whether to format data, default `true`\n\n### Returns\n#### When need_format=true:\n- post: Post detail\n - post_id: Post ID\n - post_url: Post URL\n - author_name: Author name\n - author_channel_id: Author channel ID\n - author_url: Author channel URL\n - author_thumbnails: Author avatar thumbnails\n - content_text: Post text content\n - published_time: Published time (relative)\n - vote_count: Like count\n - comment_count: Comment count\n - attachment: Attachment data (image/multi_image/video/poll, may be null)\n- channel_metadata: Channel metadata (name, description, URL, etc.)\n- comments_continuation_token: Comments pagination token\n\n#### When need_format=false:\n- Returns raw data\n\n### Notes\n- post_id starts with \"Ugk\"\n- Post attachments support: image, multi_image, video, poll types\n\n### Example\n#### Get post details: post_id = \"UgkxiCSRfD6g7SPlWGPDa3vbP7aIsytXRkvy\"\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_youtube_web_v2_get_post_detail", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n#### When need_format=true:\n- post: Post detail\n - post_id: Post ID\n - post_url: Post URL\n - author_name: Author name\n - author_channel_id: Author channel ID\n - author_url: Author channel URL\n - author_thumbnails: Author avatar thumbnails\n - content_text: Post text content\n - published_time: Published time (relative)\n - vote_count: Like count\n - comment_count: Comment count\n - attachment: Attachment data (image/multi_image/video/poll, may be null)\n- channel_metadata: Channel metadata (name, description, URL, etc.)\n- comments_continuation_token: Comments pagination token\n\n#### When need_format=false:\n- Returns raw data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "youtube get_post_detail", "tags": [ "tikhub.youtube" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web_v2", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "34fd2292fa42" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/youtube/web_v2/get_post_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_youtube_web_v2_get_post_detail", "method": "GET", "path": "/apis/v1/tikhub/youtube/web_v2/get_post_detail" }, "parameters": [ { "name": "country_code", "in": "query", "required": false, "schema": { "type": "string", "description": "Country code", "default": "US", "title": "Country Code" }, "description": "Country code", "example": "US" }, { "name": "language_code", "in": "query", "required": false, "schema": { "type": "string", "description": "Language code", "default": "zh-CN", "title": "Language Code" }, "description": "Language code", "example": "zh-CN" }, { "name": "need_format", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether to clean and format the data", "default": true, "title": "Need Format" }, "description": "Whether to clean and format the data" }, { "name": "post_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Post ID", "title": "Post Id" }, "description": "Post ID", "example": "UgkxiCSRfD6g7SPlWGPDa3vbP7aIsytXRkvy" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:8bcfb7008ab5b76d4fd6c8771f83e7667ad6d334babe17758e3bc441e527ad48" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/youtube/web_v2/get_post_detail?country_code=US&language_code=zh-CN&post_id=UgkxiCSRfD6g7SPlWGPDa3vbP7aIsytXRkvy' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-youtube-web_v2-get_post_detail" } }, "/apis/v1/tikhub/youtube/web_v2/get_related_videos": { "get": { "description": "YouTube (web_v2).\n\n### Purpose\n- Get YouTube video's related content recommendations (recommended videos list)\n- Similar to the related videos shown on the right side of video playback page\n- Returns all recommended videos at once (typically 20-30 videos)\n\n### Parameters\n- video_id: Video ID (recommended)\n- video_url: Full video URL (optional, ignored if video_id is provided)\n- need_format: Whether to format data (default true)\n - true: Return formatted structured data (recommended)\n - false: Return raw YouTube API structure (for debugging or custom parsing)\n\n### Returns\n#### When need_format=true:\n- video_id: Current video ID\n- related_videos: Related videos list\n - video_id: Related video's ID\n - title: Video title\n - author: Author name\n - author_id: Author channel ID\n - author_url: Author channel URL\n - length_text: Video duration text (e.g., \"3:45\")\n - length_seconds: Video duration in seconds\n - view_count_text: View count text (e.g., \"1.2M views\")\n - short_view_count_text: Short view count text (e.g., \"1.2M\")\n - published_time_text: Published time text (e.g., \"2 days ago\")\n - thumbnails: All resolution thumbnails\n - rich_thumbnail: Moving thumbnail (if available)\n - badges: Video badges (e.g., NEW, LIVE)\n - owner_badges: Channel verification badges\n - video_url: Video URL\n - navigation_endpoint: Navigation endpoint\n- total_count: Total number of recommended videos\n\n#### When need_format=false:\n- video_id: Current video ID\n- related_videos: Raw lockupViewModel object list\n- total_count: Total number of recommended videos\n\n### Notes\n- Each video's recommendations are generated by YouTube's algorithm and may change\n- Recommendation list typically contains 20-30 videos\n- ⚠️ **This API does not support pagination**, returns all recommendations at once\n\n### Example\n#### Get related videos: video_id = \"dQw4w9WgXcQ\"\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_youtube_web_v2_get_related_videos", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n#### When need_format=true:\n- video_id: Current video ID\n- related_videos: Related videos list\n - video_id: Related video's ID\n - title: Video title\n - author: Author name\n - author_id: Author channel ID\n - author_url: Author channel URL\n - length_text: Video duration text (e.g., \"3:45\")\n - length_seconds: Video duration in seconds\n - view_count_text: View count text (e.g., \"1.2M views\")\n - short_view_count_text: Short view count text (e.g., \"1.2M\")\n - published_time_text: Published time text (e.g., \"2 days ago\")\n - thumbnails: All resolution thumbnails\n - rich_thumbnail: Moving thumbnail (if available)\n - badges: Video badges (e.g., NEW, LIVE)\n - owner_badges: Channel verification badges\n - video_url: Video URL\n - navigation_endpoint: Navigation endpoint\n- total_count: Total number of recommended videos\n\n#### When need_format=false:\n- video_id: Current video ID\n- related_videos: Raw lockupViewModel object list\n- total_count: Total number of recommended videos", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "youtube get_related_videos", "tags": [ "tikhub.youtube" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web_v2", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "673c1cb78355" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/youtube/web_v2/get_related_videos", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_youtube_web_v2_get_related_videos", "method": "GET", "path": "/apis/v1/tikhub/youtube/web_v2/get_related_videos" }, "parameters": [ { "name": "need_format", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether to format data (default true)\n - true: Return formatted structured data (recommended)\n - false: Return raw YouTube API structure (for debugging or custom parsing)", "default": true, "title": "Need Format" }, "description": "Whether to format data (default true)\n - true: Return formatted structured data (recommended)\n - false: Return raw YouTube API structure (for debugging or custom parsing)" }, { "name": "video_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Video ID", "title": "Video Id" }, "description": "Video ID", "example": "dQw4w9WgXcQ" }, { "name": "video_url", "in": "query", "required": false, "schema": { "type": "string", "description": "Ignored if video_id is provided", "title": "Video Url" }, "description": "Ignored if video_id is provided", "example": "https://www.youtube.com/watch?v=dQw4w9WgXcQ" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:64937b592b569c4977b7f7613714064da89bc0db1727e6dc29b2150a2a4249bb" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-youtube-web_v2-get_related_videos" } }, "/apis/v1/tikhub/youtube/web_v2/get_search_suggestions": { "get": { "description": "YouTube (web_v2).\n\n### Purpose\n- Get YouTube search suggestions (autocomplete)\n- Similar to suggestions shown when typing in YouTube search box\n\n### Parameters\n- keyword: Search keyword (required)\n- language: Language code (optional, default en)\n - en: English\n - zh-cn: Simplified Chinese\n - ja: Japanese\n - ko: Korean\n- region: Region code (optional, default US)\n - US: United States\n - SG: Singapore\n - CN: China\n - JP: Japan\n - KR: Korea\n\n### Returns\n- keyword: Search keyword\n- suggestions: Suggestions list (array of strings)\n- total_count: Number of suggestions\n\n### Notes\n- Suggestions vary by language and region\n- Typically returns 10-20 suggestions\n- Very fast response (< 1 second)\n\n### Example\n#### Get search suggestions: keyword = \"Rick Astley\"\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_youtube_web_v2_get_search_suggestions", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- keyword: Search keyword\n- suggestions: Suggestions list (array of strings)\n- total_count: Number of suggestions", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "youtube get_search_suggestions", "tags": [ "tikhub.youtube" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web_v2", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "2a4c016c6ae6" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/youtube/web_v2/get_search_suggestions", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_youtube_web_v2_get_search_suggestions", "method": "GET", "path": "/apis/v1/tikhub/youtube/web_v2/get_search_suggestions" }, "parameters": [ { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "maxLength": 200, "description": "Search keyword", "title": "Keyword" }, "description": "Search keyword", "example": "Rick Astley" }, { "name": "language", "in": "query", "required": false, "schema": { "type": "string", "description": "Language code (optional, default en)\n - en: English\n - zh-cn: Simplified Chinese\n - ja: Japanese\n - ko: Korean", "default": "en", "title": "Language" }, "description": "Language code (optional, default en)\n - en: English\n - zh-cn: Simplified Chinese\n - ja: Japanese\n - ko: Korean", "example": "en" }, { "name": "region", "in": "query", "required": false, "schema": { "type": "string", "description": "Region code (optional, default US)\n - US: United States\n - SG: Singapore\n - CN: China\n - JP: Japan\n - KR: Korea", "default": "US", "title": "Region" }, "description": "Region code (optional, default US)\n - US: United States\n - SG: Singapore\n - CN: China\n - JP: Japan\n - KR: Korea", "example": "US" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:a814774b6b97c28a4e2c4f26346ebb71cd41bbe627ea31672b26b829a3313e60" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/youtube/web_v2/get_search_suggestions?keyword=Rick+Astley&language=en®ion=US' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-youtube-web_v2-get_search_suggestions" } }, "/apis/v1/tikhub/youtube/web_v2/get_shorts_search": { "get": { "description": "YouTube (web_v2).\n\n### Purpose\n- YouTube Shorts specialized search using native YouTube API\n\n### Features\n- 🎬 Specialized search for YouTube Shorts (<60 seconds)\n- 🔍 Support for multiple filter conditions and sorting options\n- 📱 Optimized for mobile short-form content\n- ⚡ Smart filtering: First request may return mixed content (long+short videos), automatically filters long videos by default\n\n### Important - YouTube Shorts Search Mechanism\nAccording to YouTube's search logic, Shorts search has these characteristics:\n1. **First request** (no continuation_token): May return mixed content (some long videos + some short videos)\n2. **Subsequent requests** (with continuation_token): Returns only pure Shorts content\n3. **Solutions**:\n - Solution A: Use `filter_mixed_content=true` (default) to automatically filter long videos\n - Solution B: Use continuation_token from first response for second request to get pure Shorts\n - Solution C: Set `filter_mixed_content=false` to get original mixed content\n\n### Parameters\n- **search_query**: Search keyword\n- **language_code**: Language code (zh-CN for Chinese, en-US for English)\n- **country_code**: Country code affecting regional relevance\n- **time_zone**: Time zone (e.g., America/Los_Angeles, Asia/Shanghai)\n- **filter_mixed_content**: Whether to filter long videos from mixed content (default true)\n\n### Shorts-specific Filters\n#### Upload Time (upload_time):\n- `hour`: Shorts uploaded in the past hour\n- `today`: Shorts uploaded today\n- `week`: Shorts uploaded this week\n- `month`: Shorts uploaded this month\n- `year`: Shorts uploaded this year\n\n#### Sort By (sort_by):\n- `relevance`: Relevance (default)\n- `upload_date`: Upload date\n- `view_count`: View count\n- `rating`: Rating\n\n### Pagination Mechanism Explained\n#### How to get continuation_token:\nExtract from response JSON, typically at one of these paths:\n```python\n# Path 1: In onResponseReceivedCommands\nresponse[\"onResponseReceivedCommands\"][0][\"appendContinuationItemsAction\"][\"continuationItems\"][-1][\"continuationItemRenderer\"][\"continuationEndpoint\"][\"continuationCommand\"][\"token\"]\n\n# Path 2: In contents\nresponse[\"contents\"][\"twoColumnSearchResultsRenderer\"][\"primaryContents\"][\"sectionListRenderer\"][\"contents\"][-1][\"continuationItemRenderer\"][\"continuationEndpoint\"][\"continuationCommand\"][\"token\"]\n```\n\n#### Usage Flow:\n1. **First request**: Don't pass continuation_token\n ```\n GET /tikhub/youtube/web_v2/get_shorts_search?search_query=python\n ```\n2. **Extract token**: Find continuation_token in response\n3. **Next requests**: Pass continuation_token to get next page\n ```\n GET /tikhub/youtube/web_v2/get_shorts_search?search_query=python&continuation_token=xxx\n ```\n\n### Response Data Structure\n```json\n{\n \"code\": 200,\n \"data\": {\n \"contents\": {\n \"twoColumnSearchResultsRenderer\": {\n \"primaryContents\": {\n \"sectionListRenderer\": {\n \"contents\": [\n {\n \"itemSectionRenderer\": {\n \"contents\": [\n {\n \"gridShelfViewModel\": {\n // Shorts video list\n \"items\": [...]\n }\n }\n ]\n }\n },\n {\n \"continuationItemRenderer\": {\n \"continuationEndpoint\": {\n \"continuationCommand\": {\n \"token\": \"xxx\" // Token for next page\n }\n }\n }\n }\n ]\n }\n }\n }\n }\n }\n}\n```\n\n### ⚠️ Recommend using V2 version\n- This endpoint returns raw YouTube data structure that requires manual parsing\n- This endpoint returns raw data. The structured V2 search variant described by the upstream is not exposed in this specification.\n\n### Returns\n- Shorts-specific search results with video list and pagination token\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_youtube_web_v2_get_shorts_search", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Response Data Structure\n```json\n{\n \"code\": 200,\n \"data\": {\n \"contents\": {\n \"twoColumnSearchResultsRenderer\": {\n \"primaryContents\": {\n \"sectionListRenderer\": {\n \"contents\": [\n {\n \"itemSectionRenderer\": {\n \"contents\": [\n {\n \"gridShelfViewModel\": {\n // Shorts video list\n \"items\": [...]\n }\n }\n ]\n }\n },\n {\n \"continuationItemRenderer\": {\n \"continuationEndpoint\": {\n \"continuationCommand\": {\n \"token\": \"xxx\" // Token for next page\n }\n }\n }\n }\n ]\n }\n }\n }\n }\n }\n}\n```\n\n### Returns\n- Shorts-specific search results with video list and pagination token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "youtube get_shorts_search", "tags": [ "tikhub.youtube" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web_v2", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "e190900167a3" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/youtube/web_v2/get_shorts_search", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_youtube_web_v2_get_shorts_search", "method": "GET", "path": "/apis/v1/tikhub/youtube/web_v2/get_shorts_search" }, "parameters": [ { "name": "continuation_token", "in": "query", "required": false, "schema": { "description": "Pagination token", "title": "Continuation Token", "type": [ "string", "null" ] }, "description": "Pagination token", "example": "" }, { "name": "country_code", "in": "query", "required": false, "schema": { "type": "string", "description": "Country code", "default": "US", "title": "Country Code" }, "description": "Country code", "example": "US" }, { "name": "filter_mixed_content", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Filter mixed content (long videos), default True", "default": true, "title": "Filter Mixed Content" }, "description": "Filter mixed content (long videos), default True", "example": true }, { "name": "language_code", "in": "query", "required": false, "schema": { "type": "string", "description": "Language code", "default": "en-US", "title": "Language Code" }, "description": "Language code", "example": "en-US" }, { "name": "search_query", "in": "query", "required": true, "schema": { "type": "string", "maxLength": 200, "description": "Search keyword", "title": "Search Query" }, "description": "Search keyword", "example": "Python" }, { "name": "sort_by", "in": "query", "required": false, "schema": { "description": "Sort by for Shorts", "title": "Sort By", "anyOf": [ { "description": "Sort by for Shorts", "title": "Sort By", "allOf": [ { "type": "string", "enum": [ "relevance", "upload_date", "view_count", "rating" ], "title": "YouTubeSearchSortAPI", "description": "YouTube - API" } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "description": "Sort by for Shorts", "examples": { "relevance": { "summary": "See API documentation", "value": "relevance" }, "upload_date": { "summary": "See API documentation", "value": "upload_date" }, "view_count": { "summary": "See API documentation", "value": "view_count" }, "rating": { "summary": "See API documentation", "value": "rating" } } }, { "name": "time_zone", "in": "query", "required": false, "schema": { "type": "string", "description": "Time zone", "default": "America/Los_Angeles", "title": "Time Zone" }, "description": "Time zone", "example": "America/Los_Angeles" }, { "name": "upload_time", "in": "query", "required": false, "schema": { "description": "Upload time filter for Shorts", "title": "Upload Time", "anyOf": [ { "description": "Upload time filter for Shorts", "title": "Upload Time", "allOf": [ { "type": "string", "enum": [ "hour", "today", "week", "month", "year" ], "title": "YouTubeUploadTimeAPI", "description": "YouTube - API" } ] }, { "type": [ "string", "null" ], "enum": [ null ] } ] }, "description": "Upload time filter for Shorts", "examples": { "hour": { "summary": "1", "value": "hour" }, "today": { "summary": "See API documentation", "value": "today" }, "week": { "summary": "See API documentation", "value": "week" }, "month": { "summary": "See API documentation", "value": "month" }, "year": { "summary": "See API documentation", "value": "year" } } } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:3ac50c40294f8384c8acdf42e837e77e10d2d72cb29265ca66641004c342229e" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/youtube/web_v2/get_shorts_search?continuation_token=&country_code=US&filter_mixed_content=true&language_code=en-US&search_query=Python&time_zone=America%2FLos_Angeles' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-youtube-web_v2-get_shorts_search" } }, "/apis/v1/tikhub/youtube/web_v2/get_signed_stream_url": { "get": { "description": "YouTube (web_v2).\n\n### Purpose:\n- Get signed playback URL for specific itag (ready to play)\n- Use with get_video_streams endpoint: first get all formats, then select itag to get playback URL\n\n### Parameters:\n- video_id: Video ID (recommended)\n- video_url: Full video URL (optional)\n- itag: Format identifier, selected from formats list returned by get_video_streams\n\n### Returns:\n- itag: Format identifier\n- url: Signed playback URL (ready to use)\n- expires_in_seconds: URL validity period (typically 6 hours = 21600 seconds)\n\n### Notes:\n- Playback URLs expire after approximately 6 hours, need to regenerate after expiration\n- URL length is long (approximately 1000-2000 characters)\n- Some videos may have regional restrictions\n\nAPI references: `get_video_streams` = `GET /tikhub/youtube/web_v2/get_video_streams` (operationId: `get_tikhub_youtube_web_v2_get_video_streams`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_youtube_web_v2_get_signed_stream_url", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- itag: Format identifier\n- url: Signed playback URL (ready to use)\n- expires_in_seconds: URL validity period (typically 6 hours = 21600 seconds)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "youtube get_signed_stream_url", "tags": [ "tikhub.youtube" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web_v2", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "eabda5377fae" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/youtube/web_v2/get_signed_stream_url", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_youtube_web_v2_get_signed_stream_url", "method": "GET", "path": "/apis/v1/tikhub/youtube/web_v2/get_signed_stream_url" }, "parameters": [ { "name": "itag", "in": "query", "required": true, "schema": { "type": "integer", "description": "Format identifier itag (obtained from get_video_streams endpoint\n\nAPI references: `get_video_streams` = `GET /tikhub/youtube/web_v2/get_video_streams` (operationId: `get_tikhub_youtube_web_v2_get_video_streams`).", "title": "Itag" }, "description": "Format identifier itag (obtained from get_video_streams endpoint\n\nAPI references: `get_video_streams` = `GET /tikhub/youtube/web_v2/get_video_streams` (operationId: `get_tikhub_youtube_web_v2_get_video_streams`).", "example": 18 }, { "name": "video_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Video ID", "title": "Video Id" }, "description": "Video ID", "example": "dQw4w9WgXcQ" }, { "name": "video_url", "in": "query", "required": false, "schema": { "type": "string", "description": "Ignored if video_id is provided", "title": "Video Url" }, "description": "Ignored if video_id is provided", "example": "https://www.youtube.com/watch?v=dQw4w9WgXcQ" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:3c227757a0ef1122d03c0ea9332618f6b7ee5a185a12680c3d40eeb96ce395d7" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/youtube/web_v2/get_signed_stream_url?itag=18&video_id=dQw4w9WgXcQ&video_url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DdQw4w9WgXcQ' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-youtube-web_v2-get_signed_stream_url" } }, "/apis/v1/tikhub/youtube/web_v2/get_video_captions": { "get": { "description": "YouTube (web_v2). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls.\n\n### Purpose\n- Get video caption list or caption content for a specific language\n- Supports multiple caption format outputs\n\n### Parameters\n- video_id: Video ID (recommended)\n- video_url: Full video URL (optional)\n- language_code: Language code (e.g. en, zh-Hans, a.en), returns available caption list if empty\n- format: Caption format\n - srt: SubRip subtitle format (with timestamps)\n - xml: Raw XML format\n - json3: JSON format (YouTube raw structure)\n - txt: Plain text (no timestamps)\n\n### Returns\n#### Without language_code (caption language list):\n```json\n{\n \"video_id\": \"dQw4w9WgXcQ\",\n \"captions\": [\n { \"language_code\": \"en\", \"language_name\": \"English\" },\n { \"language_code\": \"ja\", \"language_name\": \"Japanese\" }\n ]\n}\n```\n\n#### With language_code (caption content):\n- format=srt: Standard SRT subtitle content (with sequence numbers, timestamps, text)\n- format=txt: Plain text (text only, no timestamps)\n- format=xml: YouTube raw XML captions\n- format=json3: YouTube JSON format captions\n\n#### Large videos (async job):\n```json\n{\n \"video_id\": \"dQw4w9WgXcQ\",\n \"status\": \"processing\",\n \"job_id\": \"123e4567-e89b-12d3-a456-426614174000\"\n}\n```\n- When `status=\"processing\"` is returned, poll `/tikhub/youtube/web_v2/get_video_captions_result`\n with the `job_id` to retrieve the final captions\n\n#### Video has no captions:\n```json\n{\n \"video_id\": \"dQw4w9WgXcQ\",\n \"captions\": [],\n \"message\": \"No transcript is available for this video\",\n \"message_zh\": \"该视频没有可用字幕\"\n}\n```\n\n### Usage flow\n1. Call without language_code to get available caption list\n2. Select language_code from the list to get caption content\n\n### Notes\n- Not all videos have captions\n- Only captions that already exist on the video are returned; AI speech-to-text\n transcription is not provided. Videos without captions return the no-captions\n result shown above\n- At least one of video_id or video_url is required\n- Large videos become async jobs; poll `/tikhub/youtube/web_v2/get_video_captions_result` for the result\n- A video with no captions returns 200 with the message above and is still\n billed (the upstream provider charges for this request)\n\nAPI references: `get_video_captions_result` = `GET /tikhub/youtube/web_v2/get_video_captions_result` (operationId: `get_tikhub_youtube_web_v2_get_video_captions_result`).\n\n\nPublished reference price: $0.008 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_youtube_web_v2_get_video_captions", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n#### Without language_code (caption language list):\n```json\n{\n \"video_id\": \"dQw4w9WgXcQ\",\n \"captions\": [\n { \"language_code\": \"en\", \"language_name\": \"English\" },\n { \"language_code\": \"ja\", \"language_name\": \"Japanese\" }\n ]\n}\n```\n\n#### With language_code (caption content):\n- format=srt: Standard SRT subtitle content (with sequence numbers, timestamps, text)\n- format=txt: Plain text (text only, no timestamps)\n- format=xml: YouTube raw XML captions\n- format=json3: YouTube JSON format captions\n\n#### Large videos (async job):\n```json\n{\n \"video_id\": \"dQw4w9WgXcQ\",\n \"status\": \"processing\",\n \"job_id\": \"123e4567-e89b-12d3-a456-426614174000\"\n}\n```\n- When `status=\"processing\"` is returned, poll `/tikhub/youtube/web_v2/get_video_captions_result`\n with the `job_id` to retrieve the final captions\n\n#### Video has no captions:\n```json\n{\n \"video_id\": \"dQw4w9WgXcQ\",\n \"captions\": [],\n \"message\": \"No transcript is available for this video\",\n \"message_zh\": \"该视频没有可用字幕\"\n}\n```\n\nAPI references: `get_video_captions_result` = `GET /tikhub/youtube/web_v2/get_video_captions_result` (operationId: `get_tikhub_youtube_web_v2_get_video_captions_result`).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "youtube get_video_captions", "tags": [ "tikhub.youtube" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web_v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.008, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "b7e0ddae464f" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/youtube/web_v2/get_video_captions", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_youtube_web_v2_get_video_captions", "method": "GET", "path": "/apis/v1/tikhub/youtube/web_v2/get_video_captions" }, "parameters": [ { "name": "format", "in": "query", "required": false, "schema": { "enum": [ "srt", "xml", "json3", "txt" ], "type": "string", "description": "Caption format\n - srt: SubRip subtitle format (with timestamps)\n - xml: Raw XML format\n - json3: JSON format (YouTube raw structure)\n - txt: Plain text (no timestamps)", "default": "srt", "title": "Format" }, "description": "Caption format\n - srt: SubRip subtitle format (with timestamps)\n - xml: Raw XML format\n - json3: JSON format (YouTube raw structure)\n - txt: Plain text (no timestamps)", "example": "srt" }, { "name": "language_code", "in": "query", "required": false, "schema": { "type": "string", "description": "Language code, returns available caption list if empty", "title": "Language Code" }, "description": "Language code, returns available caption list if empty", "example": "en" }, { "name": "video_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Video ID", "title": "Video Id" }, "description": "Video ID", "example": "dQw4w9WgXcQ" }, { "name": "video_url", "in": "query", "required": false, "schema": { "type": "string", "description": "Video URL", "title": "Video Url" }, "description": "Video URL", "example": "https://www.youtube.com/watch?v=dQw4w9WgXcQ" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:6e0622e72a2a03b9d4b87269364a7a25a65f0cb9e424295adc0892564b3d8e0d" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-youtube-web_v2-get_video_captions" } }, "/apis/v1/tikhub/youtube/web_v2/get_video_captions_result": { "get": { "description": "youtube get_video_captions_result\n\n\nPublished reference price: $0.0001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_youtube_web_v2_get_video_captions_result", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n#### Processing:\n```json\n{ \"job_id\": \"123e4567-e89b-12d3-a456-426614174000\", \"status\": \"queued\" }\n```\n- status is `queued` or `active`; retry later\n\n#### Completed:\n```json\n{\n \"job_id\": \"123e4567-e89b-12d3-a456-426614174000\",\n \"status\": \"completed\",\n \"language_code\": \"en\",\n \"language_name\": \"English\",\n \"format\": \"srt\",\n \"content\": \"\",\n \"available_languages\": [\"en\", \"ja\"]\n}\n```", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "youtube get_video_captions_result", "tags": [ "tikhub.youtube" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": true, "mpp_methods": [ "GET" ], "x402": false }, "x-aisa-category": "web_v2", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "explicit_zero", "customer_pricing": "fixed_success", "default_request_estimate_usd": 0.0001, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "021c4eec662d", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "21f301508359" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/youtube/web_v2/get_video_captions_result", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_youtube_web_v2_get_video_captions_result", "method": "GET", "path": "/apis/v1/tikhub/youtube/web_v2/get_video_captions_result" }, "parameters": [ { "name": "format", "in": "query", "required": false, "schema": { "enum": [ "srt", "xml", "json3", "txt" ], "type": "string", "description": "Caption format (applies only when the job is completed)\n - srt: SubRip subtitle format (with timestamps)\n - xml: XML format\n - json3: JSON format\n - txt: Plain text (no timestamps)", "default": "srt", "title": "Format" }, "description": "Caption format (applies only when the job is completed)\n - srt: SubRip subtitle format (with timestamps)\n - xml: XML format\n - json3: JSON format\n - txt: Plain text (no timestamps)", "example": "srt" }, { "name": "job_id", "in": "query", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 128, "pattern": "^[A-Za-z0-9_-]+$", "description": "Async job ID (returned by `/tikhub/youtube/web_v2/get_video_captions`)\n\nAPI references: `get_video_captions` = `GET /tikhub/youtube/web_v2/get_video_captions` (operationId: `get_tikhub_youtube_web_v2_get_video_captions`).", "title": "Job Id" }, "description": "Async job ID (returned by `/tikhub/youtube/web_v2/get_video_captions`)\n\nAPI references: `get_video_captions` = `GET /tikhub/youtube/web_v2/get_video_captions` (operationId: `get_tikhub_youtube_web_v2_get_video_captions`).", "example": "123e4567-e89b-12d3-a456-426614174000" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:08b02d0f61e4033a4d8022cc34109e0a3f0f21354d197b51bb081d7dee3d2522" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/youtube/web_v2/get_video_captions_result?format=srt&job_id=123e4567-e89b-12d3-a456-426614174000' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-youtube-web_v2-get_video_captions_result" } }, "/apis/v1/tikhub/youtube/web_v2/get_video_comment_replies": { "get": { "description": "YouTube (web_v2).\n\n### Purpose:\n- Get video second-level comment replies\n\n### Parameters:\n\n#### Required:\n**continuation_token** (string)\n- **Purpose**: Reply continuation token from first-level comment\n- **How to get**: Extract `reply_continuation_token` from the first-level comment response\n\n#### Optional:\n**language_code** (string, optional)\n- **Purpose**: Language preference for comments\n- **Default**: `\"zh-CN\"`\n\n**country_code** (string, optional)\n- **Purpose**: Region code\n- **Default**: `\"US\"`\n\n**need_format** (boolean, optional)\n- **Purpose**: Whether to return cleaned simplified data\n- **Default**: `true`\n\n### Returns:\n- `replies`: List of reply comments\n- `continuation_token`: Next page token (if more replies available)\n\n### Usage flow:\n1. Get first-level comments via `get_video_comments`\n2. Extract `reply_continuation_token` from a comment that has replies\n3. Pass it as `continuation_token` to this endpoint\n4. For more replies, use the returned `continuation_token`\n\nAPI references: `get_video_comments` = `GET /tikhub/youtube/web_v2/get_video_comments` (operationId: `get_tikhub_youtube_web_v2_get_video_comments`).\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_youtube_web_v2_get_video_comment_replies", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- `replies`: List of reply comments\n- `continuation_token`: Next page token (if more replies available)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "youtube get_video_comment_replies", "tags": [ "tikhub.youtube" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web_v2", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "6dcc87fb29e8" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/youtube/web_v2/get_video_comment_replies", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_youtube_web_v2_get_video_comment_replies", "method": "GET", "path": "/apis/v1/tikhub/youtube/web_v2/get_video_comment_replies" }, "parameters": [ { "name": "continuation_token", "in": "query", "required": true, "schema": { "type": "string", "description": "Reply continuation token from first-level comment Use a first-level comment's `reply_continuation_token` to request its replies. Call `GET /tikhub/youtube/web_v2/get_video_comments` (operationId: `get_tikhub_youtube_web_v2_get_video_comments`).", "title": "Continuation Token" }, "description": "Reply continuation token from first-level comment Use a first-level comment's `reply_continuation_token` to request its replies. Call `GET /tikhub/youtube/web_v2/get_video_comments` (operationId: `get_tikhub_youtube_web_v2_get_video_comments`)." }, { "name": "country_code", "in": "query", "required": false, "schema": { "type": "string", "description": "Country code", "default": "US", "title": "Country Code" }, "description": "Country code", "example": "US" }, { "name": "language_code", "in": "query", "required": false, "schema": { "type": "string", "description": "Language code", "default": "zh-CN", "title": "Language Code" }, "description": "Language code", "example": "zh-CN" }, { "name": "need_format", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether to clean and format the data", "default": true, "title": "Need Format" }, "description": "Whether to clean and format the data" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:16d2e7057d12c3b78b42c1db93940925704a19dd4afab2d2d68abbe004dc7f3a" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-youtube-web_v2-get_video_comment_replies" } }, "/apis/v1/tikhub/youtube/web_v2/get_video_comments": { "get": { "description": "YouTube (web_v2).\n\n### Purpose:\n- Get YouTube video first-level comments\n\n### Parameters:\n\n#### 📌 Required:\n**video_id** (string)\n- **Purpose**: Video ID\n- **Format**: YouTube video ID string\n- **Example**: `\"oaSNBz4qMQY\"`\n- **How to get**: Extract from URL `https://www.youtube.com/watch?v=oaSNBz4qMQY`\n\n#### ⚙️ Optional:\n**language_code** (string, optional)\n- **Purpose**: Set language preference for comments\n- **Default**: `\"zh-CN\"`\n- **Values**: `\"zh-CN\"`, `\"en-US\"`, `\"ja-JP\"`, `\"ko-KR\"`, etc.\n\n**country_code** (string, optional)\n- **Purpose**: Set region code\n- **Default**: `\"US\"`\n- **Values**: `\"US\"`, `\"JP\"`, `\"GB\"`, etc.\n\n**sort_by** (string, optional)\n- **Purpose**: Comment sorting method\n- **Default**: `\"top\"`\n- **Values**:\n - `\"top\"` - Top comments (sorted by likes)\n - `\"newest\"` - Newest comments (sorted by time)\n\n**continuation_token** (string, optional)\n- **Purpose**: Pagination token for next page\n- **Default**: `null`\n- **How to get**: Extract from previous response\n\n**need_format** (boolean, optional)\n- **Purpose**: Whether to return cleaned simplified data\n- **Default**: `true`\n- **Values**:\n - `false` - Return raw complete data\n - `true` - Return cleaned simplified data (recommended, default)\n\n### Response Structure (need_format=true):\n```json\n{\n \"comments\": [\n {\n \"comment_id\": \"UgzRDoUJAvDNn5_8i8p4AaABAg\",\n \"content\": \"Comment text content\",\n \"published_time\": \"1 day ago\",\n \"reply_level\": 0,\n \"like_count\": \"2\",\n \"like_count_a11y\": \"2 likes\",\n \"reply_count\": \"0\",\n \"reply_count_a11y\": \"0 replies\",\n \"reply_count_text\": \"1 reply\",\n \"reply_continuation_token\": \"...\",\n \"author\": {\n \"channel_id\": \"UCzRzHrLFuH0lHZYnrI84I8Q\",\n \"display_name\": \"@username\",\n \"channel_url\": \"https://www.youtube.com/@username\",\n \"avatar_url\": \"https://yt3.ggpht.com/...\",\n \"avatar_thumbnails\": [\n {\"url\": \"...\", \"width\": 88, \"height\": 88}\n ],\n \"is_verified\": false,\n \"is_creator\": false,\n \"is_artist\": false\n },\n \"creator_thumbnail_url\": \"https://yt3.ggpht.com/...\"\n }\n ],\n \"continuation_token\": \"next page token\"\n}\n```\n\n### Field Descriptions:\n- `comment_id`: Unique comment ID\n- `content`: Comment text content\n- `published_time`: Published time (relative, e.g., \"1 day ago\")\n- `reply_level`: Reply level (0 for first-level comments)\n- `like_count`: Number of likes\n- `reply_count`: Number of replies\n- `reply_count_text`: Reply count text (e.g., \"1 reply\")\n- `reply_continuation_token`: Token to get replies for this comment\n- `author`: Comment author info\n - `channel_id`: Author's channel ID\n - `display_name`: Display name\n - `channel_url`: Channel URL\n - `avatar_url`: Avatar URL\n - `is_verified`: Whether verified\n - `is_creator`: Whether video creator\n - `is_artist`: Whether artist\n- `creator_thumbnail_url`: Video creator's avatar URL\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_youtube_web_v2_get_video_comments", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Response Structure (need_format=true)\n```json\n{\n \"comments\": [\n {\n \"comment_id\": \"UgzRDoUJAvDNn5_8i8p4AaABAg\",\n \"content\": \"Comment text content\",\n \"published_time\": \"1 day ago\",\n \"reply_level\": 0,\n \"like_count\": \"2\",\n \"like_count_a11y\": \"2 likes\",\n \"reply_count\": \"0\",\n \"reply_count_a11y\": \"0 replies\",\n \"reply_count_text\": \"1 reply\",\n \"reply_continuation_token\": \"...\",\n \"author\": {\n \"channel_id\": \"UCzRzHrLFuH0lHZYnrI84I8Q\",\n \"display_name\": \"@username\",\n \"channel_url\": \"https://www.youtube.com/@username\",\n \"avatar_url\": \"https://yt3.ggpht.com/...\",\n \"avatar_thumbnails\": [\n {\"url\": \"...\", \"width\": 88, \"height\": 88}\n ],\n \"is_verified\": false,\n \"is_creator\": false,\n \"is_artist\": false\n },\n \"creator_thumbnail_url\": \"https://yt3.ggpht.com/...\"\n }\n ],\n \"continuation_token\": \"next page token\"\n}\n```", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "youtube get_video_comments", "tags": [ "tikhub.youtube" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web_v2", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "72c2b02ab5a2" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/youtube/web_v2/get_video_comments", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_youtube_web_v2_get_video_comments", "method": "GET", "path": "/apis/v1/tikhub/youtube/web_v2/get_video_comments" }, "parameters": [ { "name": "continuation_token", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination token", "title": "Continuation Token" }, "description": "Pagination token" }, { "name": "country_code", "in": "query", "required": false, "schema": { "type": "string", "description": "Country code", "default": "US", "title": "Country Code" }, "description": "Country code", "example": "US" }, { "name": "language_code", "in": "query", "required": false, "schema": { "type": "string", "description": "Language code", "default": "zh-CN", "title": "Language Code" }, "description": "Language code", "example": "zh-CN" }, { "name": "need_format", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether to clean and format the data", "default": true, "title": "Need Format" }, "description": "Whether to clean and format the data" }, { "name": "sort_by", "in": "query", "required": false, "schema": { "description": "Sort by", "default": "top", "allOf": [ { "type": "string", "enum": [ "top", "newest" ], "title": "CommentSortByAPI", "description": "See API documentation" } ] }, "description": "Sort by", "examples": { "top": { "summary": "See API documentation", "value": "top" }, "newest": { "summary": "See API documentation", "value": "newest" } } }, { "name": "video_id", "in": "query", "required": true, "schema": { "type": "string", "minLength": 11, "maxLength": 11, "description": "Video ID", "title": "Video Id" }, "description": "Video ID", "example": "LuIL5JATZsc" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:8919fc3c04d2fd3d7ed9dd94cda8fe316b996ce6ac728f252ee377a4dd9420a4" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/youtube/web_v2/get_video_comments?country_code=US&language_code=zh-CN&video_id=LuIL5JATZsc' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-youtube-web_v2-get_video_comments" } }, "/apis/v1/tikhub/youtube/web_v2/get_video_info": { "get": { "description": "YouTube (web_v2).\n\n### Purpose:\n- Get YouTube video details\n- Returns raw complete data (includes playerResponse and initialData)\n\n### Parameters:\n\n#### 📌 Required:\n**video_id** (string)\n- **Purpose**: Video ID\n- **How to get**: Extract from video URL, e.g., `https://www.youtube.com/watch?v=oaSNBz4qMQY`, video_id is `oaSNBz4qMQY`\n- **Example**: `\"oaSNBz4qMQY\"`\n\n#### ⚙️ Optional:\n**language_code** (string, optional)\n- **Purpose**: Set language preference\n- **Default**: `\"zh-CN\"`\n- **Values**: `\"zh-CN\"`, `\"en-US\"`, `\"ja-JP\"`, `\"ko-KR\"`, etc.\n\n### Response Structure:\n```json\n{\n \"playerResponse\": {\n \"videoDetails\": {},\n \"streamingData\": {\n \"formats\": [],\n \"adaptiveFormats\": []\n },\n \"microformat\": {},\n ...\n },\n \"initialData\": {\n \"contents\": {\n \"twoColumnWatchNextResults\": {\n \"results\": {\n \"results\": {\n \"contents\": [\n {\n \"videoPrimaryInfoRenderer\": {...},\n \"videoSecondaryInfoRenderer\": {...}\n }\n ]\n }\n }\n }\n },\n ...\n }\n}\n```\n\n### Key Fields:\n- `playerResponse`: YouTube player response data\n - `videoDetails`: Basic video info (may be empty depending on YouTube's response)\n - `streamingData`: Video stream data (includes formats and adaptiveFormats with googlevideo.com URLs)\n - `microformat`: Metadata information\n- `initialData`: YouTube page initialization data\n - `videoPrimaryInfoRenderer`: Primary info (title, view count, like count, etc.)\n - `videoSecondaryInfoRenderer`: Secondary info (channel info, description, etc.)\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_youtube_web_v2_get_video_info", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Response Structure\n```json\n{\n \"playerResponse\": {\n \"videoDetails\": {},\n \"streamingData\": {\n \"formats\": [],\n \"adaptiveFormats\": []\n },\n \"microformat\": {},\n ...\n },\n \"initialData\": {\n \"contents\": {\n \"twoColumnWatchNextResults\": {\n \"results\": {\n \"results\": {\n \"contents\": [\n {\n \"videoPrimaryInfoRenderer\": {...},\n \"videoSecondaryInfoRenderer\": {...}\n }\n ]\n }\n }\n }\n },\n ...\n }\n}\n```", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "youtube get_video_info", "tags": [ "tikhub.youtube" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web_v2", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "05a5c3b0c151" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/youtube/web_v2/get_video_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_youtube_web_v2_get_video_info", "method": "GET", "path": "/apis/v1/tikhub/youtube/web_v2/get_video_info" }, "parameters": [ { "name": "language_code", "in": "query", "required": false, "schema": { "type": "string", "description": "Language code", "default": "zh-CN", "title": "Language Code" }, "description": "Language code", "example": "zh-CN" }, { "name": "need_format", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether to clean and format the data", "default": true, "title": "Need Format" }, "description": "Whether to clean and format the data" }, { "name": "video_id", "in": "query", "required": true, "schema": { "type": "string", "minLength": 11, "maxLength": 11, "description": "Video ID", "title": "Video Id" }, "description": "Video ID", "example": "oaSNBz4qMQY" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:5edc720ac8336fa13bb6cdb10b8ec65cd057d9e6e7409755a053a4d138b10319" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/tikhub/youtube/web_v2/get_video_info?language_code=zh-CN&video_id=oaSNBz4qMQY' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-youtube-web_v2-get_video_info" } }, "/apis/v1/tikhub/youtube/web_v2/get_video_streams": { "get": { "description": "YouTube (web_v2).\n\n### ⚠️ Important Notice\n- **This endpoint ONLY returns format information, URL fields are null**\n- **MUST use get_signed_stream_url endpoint to get playback URLs**\n- For getting all URLs at once, use get_video_streams_v2 endpoint\n\n### Purpose\n- Get all quality format information for YouTube video\n- Returns standard formats (merged audio/video) and adaptive formats (separate audio/video)\n\n### Parameters\n- video_id: Video ID (recommended)\n- video_url: Full video URL (optional, ignored if video_id is provided)\n\n### Returns\n- Basic video info (title, author, duration, view count, etc.)\n- formats: Standard format streams (audio and video combined)\n- adaptive_formats: Adaptive format streams (video-only or audio-only)\n - Each format contains: itag, mime_type, quality label, resolution, bitrate, etc.\n - ⚠️ **url field is null** (YouTube requires signature decryption to get actual playback URL)\n - has_signature=true means need to use get_signed_stream_url endpoint\n- hls_manifest_url: HLS manifest URL (if available)\n- dash_manifest_url: DASH manifest URL (if available)\n- available_qualities: List of all available quality levels\n\n### Usage Flow (Two-Step Method)\n1. **Step 1**: Call this endpoint to get all available format information (URLs are null)\n2. **Step 2**: Select the desired itag from returned formats or adaptive_formats\n3. **Step 3**: Call get_signed_stream_url endpoint with video_id and itag to get actual playback URL\n\n### Notes\n- YouTube video playback URLs require signature decryption, null URL fields in raw API response is normal\n- Playback URLs must be obtained separately via get_signed_stream_url endpoint\n- High-quality videos (720p+) usually require separate download and merge of audio/video streams\n\n### Example\n#### Step 1 - Get format information: video_id = \"dQw4w9WgXcQ\"\n#### Step 2 - Get playback URLs: use get_signed_stream_url with selected itag\n\nAPI references: `get_signed_stream_url` = `GET /tikhub/youtube/web_v2/get_signed_stream_url` (operationId: `get_tikhub_youtube_web_v2_get_signed_stream_url`).\n\nUpstream-only reference: `get_video_streams_v2` is `GET /api/v1/youtube/web_v2/get_video_streams_v2` in the official API. It is not exposed as an operation in this specification.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_youtube_web_v2_get_video_streams", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- Basic video info (title, author, duration, view count, etc.)\n- formats: Standard format streams (audio and video combined)\n- adaptive_formats: Adaptive format streams (video-only or audio-only)\n - Each format contains: itag, mime_type, quality label, resolution, bitrate, etc.\n - ⚠️ **url field is null** (YouTube requires signature decryption to get actual playback URL)\n - has_signature=true means need to use get_signed_stream_url endpoint\n- hls_manifest_url: HLS manifest URL (if available)\n- dash_manifest_url: DASH manifest URL (if available)\n- available_qualities: List of all available quality levels\n\nAPI references: `get_signed_stream_url` = `GET /tikhub/youtube/web_v2/get_signed_stream_url` (operationId: `get_tikhub_youtube_web_v2_get_signed_stream_url`).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "youtube get_video_streams", "tags": [ "tikhub.youtube" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web_v2", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "0097b49b1613" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/youtube/web_v2/get_video_streams", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_youtube_web_v2_get_video_streams", "method": "GET", "path": "/apis/v1/tikhub/youtube/web_v2/get_video_streams" }, "parameters": [ { "name": "video_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Video ID", "title": "Video Id" }, "description": "Video ID", "example": "dQw4w9WgXcQ" }, { "name": "video_url", "in": "query", "required": false, "schema": { "type": "string", "description": "Ignored if video_id is provided", "title": "Video Url" }, "description": "Ignored if video_id is provided", "example": "https://www.youtube.com/watch?v=dQw4w9WgXcQ" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:2ad3a3233a4e08325398374b8ff6a471735f52751a0e412f1c9f20c5466eff1d" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-youtube-web_v2-get_video_streams" } }, "/apis/v1/tikhub/youtube/web_v2/search_channels": { "get": { "description": "YouTube (web_v2).\n\n### Purpose\n- Search YouTube channels\n- Only returns channel-type search results (filters out videos, playlists, etc.)\n- Supports pagination to get more channels\n\n### Parameters\n- keyword: Search keyword (required for first request)\n- continuation_token: Pagination token (optional, for next page)\n- need_format: Whether to format data (default true)\n - true: Return formatted structured data (recommended)\n - false: Return raw YouTube API structure (for debugging)\n\n### Returns\n#### When need_format=true:\n- keyword: Search keyword\n- channels: Channels list\n - channel_id: Channel ID (e.g., \"UCjuNibFJ21MiSNpu8LZyV4w\")\n - title: Channel name\n - handle: Channel custom handle (e.g., \"@chaijing2023\")\n - subscriber_count_text: Subscriber count text (e.g., \"1.11M subscribers\")\n - description: Channel description snippet\n - thumbnails: Thumbnail list (multiple sizes)\n - is_subscribed: Whether current user is subscribed to this channel (boolean)\n - canonical_url: Channel canonical URL path (e.g., \"/@chaijing2023\")\n - channel_url: Full channel URL (prefers custom URL)\n- continuation_token: Next page pagination token\n- has_more: Whether there are more channels\n- total_count: Current page channel count\n\n#### When need_format=false:\n- keyword: Search keyword\n- channels: Raw channelRenderer object list\n- continuation_token: Next page pagination token\n- has_more: Whether there are more channels\n- total_count: Current page channel count\n\n### Usage Flow\n1. First request: Only pass keyword parameter\n2. Get continuation_token from response\n3. Next request: Pass continuation_token (keyword optional)\n4. Repeat steps 2-3 until has_more is false\n\n### Notes\n- Each page typically returns 10-20 channels\n- Search results only include channels, not videos, playlists, etc.\n- Order and quantity of results determined by YouTube algorithm\n\n### Example\n#### Search channels: keyword = \"Rick Astley\"\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_youtube_web_v2_search_channels", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n#### When need_format=true:\n- keyword: Search keyword\n- channels: Channels list\n - channel_id: Channel ID (e.g., \"UCjuNibFJ21MiSNpu8LZyV4w\")\n - title: Channel name\n - handle: Channel custom handle (e.g., \"@chaijing2023\")\n - subscriber_count_text: Subscriber count text (e.g., \"1.11M subscribers\")\n - description: Channel description snippet\n - thumbnails: Thumbnail list (multiple sizes)\n - is_subscribed: Whether current user is subscribed to this channel (boolean)\n - canonical_url: Channel canonical URL path (e.g., \"/@chaijing2023\")\n - channel_url: Full channel URL (prefers custom URL)\n- continuation_token: Next page pagination token\n- has_more: Whether there are more channels\n- total_count: Current page channel count\n\n#### When need_format=false:\n- keyword: Search keyword\n- channels: Raw channelRenderer object list\n- continuation_token: Next page pagination token\n- has_more: Whether there are more channels\n- total_count: Current page channel count", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "youtube search_channels", "tags": [ "tikhub.youtube" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "web_v2", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "5859e5434421" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/youtube/web_v2/search_channels", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_youtube_web_v2_search_channels", "method": "GET", "path": "/apis/v1/tikhub/youtube/web_v2/search_channels" }, "parameters": [ { "name": "continuation_token", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination token (optional, for next page)", "title": "Continuation Token" }, "description": "Pagination token (optional, for next page)" }, { "name": "keyword", "in": "query", "required": false, "schema": { "description": "Search keyword (required for first request)", "title": "Keyword", "type": [ "string", "null" ], "maxLength": 200 }, "description": "Search keyword (required for first request)", "example": "Rick Astley" }, { "name": "need_format", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Whether to format data (default true)\n - true: Return formatted structured data (recommended)\n - false: Return raw YouTube API structure (for debugging)", "default": true, "title": "Need Format" }, "description": "Whether to format data (default true)\n - true: Return formatted structured data (recommended)\n - false: Return raw YouTube API structure (for debugging)" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:a3bbe3c61c6302d8ee1341ed0f73df8dfd53d1e128495a8d4cab143da4a3e3b2" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-youtube-web_v2-search_channels" } }, "/apis/v1/tikhub/zhihu/web/fetch_ai_search_stream": { "get": { "description": "Zhihu (web).\n\n### Purpose:\n- Get Zhihu AI Search results (new endpoint)\n### Parameters:\n- message_content: Search Content\n- chat_mode: Chat mode, default FAST\n- session_id: Session ID for multi-turn\n### Returns:\n- Zhihu AI Search results as an event list {\"events\": [...]}\n\n\nPublished reference price: $0.005 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_zhihu_web_fetch_ai_search_stream", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Zhihu AI Search results as an event list {\"events\": [...]}", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "zhihu fetch_ai_search_stream", "tags": [ "tikhub.zhihu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.005, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "737e6a9e2b03" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/zhihu/web/fetch_ai_search_stream", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_zhihu_web_fetch_ai_search_stream", "method": "GET", "path": "/apis/v1/tikhub/zhihu/web/fetch_ai_search_stream" }, "parameters": [ { "name": "chat_mode", "in": "query", "required": false, "schema": { "type": "string", "description": "Chat mode", "default": "FAST", "title": "Chat Mode" }, "description": "Chat mode" }, { "name": "message_content", "in": "query", "required": true, "schema": { "type": "string", "description": "Search Content", "title": "Message Content" }, "description": "Search Content" }, { "name": "session_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Session ID", "default": "", "title": "Session Id" }, "description": "Session ID" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:6dda67751c22e6468c59b71e82cdd37d2eb72f1b3a921b3c70f73847380aaf8c" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-zhihu-web-fetch_ai_search_stream" } }, "/apis/v1/tikhub/zhihu/web/fetch_answer_detail": { "get": { "description": "Zhihu (web).\n\n### Purpose:\n- Get a single Zhihu answer's detail (content / stats / author / question, etc.)\n### Parameters:\n- answer_id: Answer ID (the numeric id in the page URL .../answer/{answer_id})\n### Returns:\n- Zhihu Answer Detail\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_zhihu_web_fetch_answer_detail", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Zhihu Answer Detail", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "zhihu fetch_answer_detail", "tags": [ "tikhub.zhihu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "4c18cd931eb5" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/zhihu/web/fetch_answer_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_zhihu_web_fetch_answer_detail", "method": "GET", "path": "/apis/v1/tikhub/zhihu/web/fetch_answer_detail" }, "parameters": [ { "name": "answer_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Answer ID (the numeric id in the page URL .../answer{answer_id})", "title": "Answer Id" }, "description": "Answer ID (the numeric id in the page URL .../answer{answer_id})" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:3ba22739151672463a9ff1b6755e2d024e1d507ebde3554114ec40d067321c85" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-zhihu-web-fetch_answer_detail" } }, "/apis/v1/tikhub/zhihu/web/fetch_article_search_v3": { "get": { "description": "Zhihu (web).\n\n### Purpose:\n- Get Zhihu Article Search V3\n### Parameters:\n- keyword: Search Keywords\n- offset: Offset\n- limit: Number of articles per page\n- show_all_topics: Show all topics\n - 0 Do not show topics\n - 1 Show topics\n- search_source: Search Source\n - Filter parameter takes effect\n - Normal is normal result\n- search_hash_id: Search Hash ID, used to filter duplicate search results\n- vertical: Empty unlimited type\n - answer only see answers\n - article only see articles\n - zvideo only see videos\n- sort: Empty comprehensive sorting\n - upvoted_count most upvoted\n - created_time latest release\n- time_interval: Time interval\n - Empty unlimited time\n - a_day within a day\n - a_week within a week\n - a_month within a month\n - three_months within three months\n - half_a_year within half a year\n - a_year within a year\n- vertical_info: Vertical information\n - 0,0,0,0,0,0,0,0,0,0,0,0 unlimited type, do not set do not fill\n### Returns:\n- Zhihu Article Search V3\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_zhihu_web_fetch_article_search_v3", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Zhihu Article Search V3", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "zhihu fetch_article_search", "tags": [ "tikhub.zhihu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "374ee8577f69" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/zhihu/web/fetch_article_search_v3", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_zhihu_web_fetch_article_search_v3", "method": "GET", "path": "/apis/v1/tikhub/zhihu/web/fetch_article_search_v3" }, "parameters": [ { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Search Keywords", "title": "Keyword" }, "description": "Search Keywords" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string", "description": "Number of articles per page", "default": "20", "title": "Limit" }, "description": "Number of articles per page" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "string", "description": "Offset", "default": "0", "title": "Offset" }, "description": "Offset" }, { "name": "search_hash_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Search Hash ID, used to filter duplicate search results", "default": "", "title": "Search Hash Id" }, "description": "Search Hash ID, used to filter duplicate search results" }, { "name": "search_source", "in": "query", "required": false, "schema": { "type": "string", "description": "Search Source\n - Filter parameter takes effect\n - Normal is normal result", "default": "Normal", "title": "Search Source" }, "description": "Search Source\n - Filter parameter takes effect\n - Normal is normal result" }, { "name": "show_all_topics", "in": "query", "required": false, "schema": { "type": "integer", "description": "Show all topics\n - 0 Do not show topics\n - 1 Show topics", "default": 0, "title": "Show All Topics" }, "description": "Show all topics\n - 0 Do not show topics\n - 1 Show topics" }, { "name": "sort", "in": "query", "required": false, "schema": { "type": "string", "description": "Empty comprehensive sorting\n - upvoted_count most upvoted\n - created_time latest release", "default": "", "title": "Sort" }, "description": "Empty comprehensive sorting\n - upvoted_count most upvoted\n - created_time latest release" }, { "name": "time_interval", "in": "query", "required": false, "schema": { "type": "string", "description": "Time interval\n - Empty unlimited time\n - a_day within a day\n - a_week within a week\n - a_month within a month\n - three_months within three months\n - half_a_year within half a year\n - a_year within a year", "default": "", "title": "Time Interval" }, "description": "Time interval\n - Empty unlimited time\n - a_day within a day\n - a_week within a week\n - a_month within a month\n - three_months within three months\n - half_a_year within half a year\n - a_year within a year" }, { "name": "vertical", "in": "query", "required": false, "schema": { "type": "string", "description": "Vertical type\n\nUsage: Empty unlimited type\n - answer only see answers\n - article only see articles\n - zvideo only see videos", "default": "", "title": "Vertical" }, "description": "Vertical type\n\nUsage: Empty unlimited type\n - answer only see answers\n - article only see articles\n - zvideo only see videos" }, { "name": "vertical_info", "in": "query", "required": false, "schema": { "type": "string", "description": "Vertical information\n - 0,0,0,0,0,0,0,0,0,0,0,0 unlimited type, do not set do not fill", "default": "", "title": "Vertical Info" }, "description": "Vertical information\n - 0,0,0,0,0,0,0,0,0,0,0,0 unlimited type, do not set do not fill" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:c2df0d1c53c83d9e11fccc23138dda187064e159c5c9cb8a67bbbec290a99771" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-zhihu-web-fetch_article_search_v3" } }, "/apis/v1/tikhub/zhihu/web/fetch_column_article_detail": { "get": { "description": "Zhihu (web).\n\n### Purpose:\n- Get Zhihu Column Article Detail\n### Parameters:\n- article_id: Article ID\n### Returns:\n- Zhihu Column Article Detail\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_zhihu_web_fetch_column_article_detail", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Zhihu Column Article Detail", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "zhihu fetch_column_article_detail", "tags": [ "tikhub.zhihu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "8447ab522e66" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/zhihu/web/fetch_column_article_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_zhihu_web_fetch_column_article_detail", "method": "GET", "path": "/apis/v1/tikhub/zhihu/web/fetch_column_article_detail" }, "parameters": [ { "name": "article_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Article ID", "title": "Article Id" }, "description": "Article ID" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:733bf61902b4dbc6cd5f0290602c04ef7551b8a5aee154460308b7da153650c1" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-zhihu-web-fetch_column_article_detail" } }, "/apis/v1/tikhub/zhihu/web/fetch_column_articles": { "get": { "description": "Zhihu (web).\n\n### Purpose:\n- Get Zhihu Column Articles\n### Parameters:\n- column_id: Column ID\n- limit: Number of articles per page\n- offset: Offset\n### Returns:\n- Zhihu Column Articles\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_zhihu_web_fetch_column_articles", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Zhihu Column Articles", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "zhihu fetch_column_articles", "tags": [ "tikhub.zhihu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "33df8ca0e6df" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/zhihu/web/fetch_column_articles", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_zhihu_web_fetch_column_articles", "method": "GET", "path": "/apis/v1/tikhub/zhihu/web/fetch_column_articles" }, "parameters": [ { "name": "column_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Column ID", "title": "Column Id" }, "description": "Column ID" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string", "description": "Number of articles per page", "default": "10", "title": "Limit" }, "description": "Number of articles per page" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "string", "description": "Offset", "default": "0", "title": "Offset" }, "description": "Offset" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:ffbadf1a6a14e042db6ff84da5ade2b948c325570a94b4a07eee686647417d19" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-zhihu-web-fetch_column_articles" } }, "/apis/v1/tikhub/zhihu/web/fetch_column_comment_config": { "get": { "description": "Zhihu (web).\n\n### Purpose:\n- Get Zhihu Column Comment Config\n### Parameters:\n- article_id: Article ID\n### Returns:\n- Zhihu Column Comment Config\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_zhihu_web_fetch_column_comment_config", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Zhihu Column Comment Config", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "zhihu fetch_column_comment_config", "tags": [ "tikhub.zhihu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "54525e574e5d" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/zhihu/web/fetch_column_comment_config", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_zhihu_web_fetch_column_comment_config", "method": "GET", "path": "/apis/v1/tikhub/zhihu/web/fetch_column_comment_config" }, "parameters": [ { "name": "article_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Article ID", "title": "Article Id" }, "description": "Article ID" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:90456a4081b1911229a99e131847e83acd7aa18578e7f8094614e6de2dea2264" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-zhihu-web-fetch_column_comment_config" } }, "/apis/v1/tikhub/zhihu/web/fetch_column_recommend": { "get": { "description": "Zhihu (web).\n\n### Purpose:\n- Get Zhihu Similar Column Recommend\n### Parameters:\n- article_id: Article ID\n- limit: Number of columns per page\n- offset: Offset\n### Returns:\n- Zhihu Similar Column Recommend\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_zhihu_web_fetch_column_recommend", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Zhihu Similar Column Recommend", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "zhihu fetch_column_recommend", "tags": [ "tikhub.zhihu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "cc2e555b552c" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/zhihu/web/fetch_column_recommend", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_zhihu_web_fetch_column_recommend", "method": "GET", "path": "/apis/v1/tikhub/zhihu/web/fetch_column_recommend" }, "parameters": [ { "name": "article_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Article ID", "title": "Article Id" }, "description": "Article ID" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string", "description": "Number of columns per page", "default": "12", "title": "Limit" }, "description": "Number of columns per page" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "string", "description": "Offset", "default": "0", "title": "Offset" }, "description": "Offset" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:cdd11211306b2cc711e40e7292f24c8e6c6da0ea18f2073aeec2919a675e82b7" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-zhihu-web-fetch_column_recommend" } }, "/apis/v1/tikhub/zhihu/web/fetch_column_relationship": { "get": { "description": "Zhihu (web).\n\n### Purpose:\n- Get Zhihu Column Relationship\n### Parameters:\n- article_id: Article ID\n### Returns:\n- Zhihu Column Relationship\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_zhihu_web_fetch_column_relationship", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Zhihu Column Relationship", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "zhihu fetch_column_relationship", "tags": [ "tikhub.zhihu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "6da61e5e5b48" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/zhihu/web/fetch_column_relationship", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_zhihu_web_fetch_column_relationship", "method": "GET", "path": "/apis/v1/tikhub/zhihu/web/fetch_column_relationship" }, "parameters": [ { "name": "article_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Article ID", "title": "Article Id" }, "description": "Article ID" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:0e9e0b0322b66086d73f0583a691e58c3ed5c41ab7a1e5ea4c54dea72143d2b4" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-zhihu-web-fetch_column_relationship" } }, "/apis/v1/tikhub/zhihu/web/fetch_column_search_v3": { "get": { "description": "Zhihu (web).\n\n### Purpose:\n- Get Zhihu Column Search V3\n### Parameters:\n- keyword: Search Keywords\n- offset: Offset\n- limit: Number of columns per page\n- search_hash_id: Search Hash ID\n### Returns:\n- Zhihu Column Search V3\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_zhihu_web_fetch_column_search_v3", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Zhihu Column Search V3", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "zhihu fetch_column_search", "tags": [ "tikhub.zhihu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "5d17839e8dfc" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/zhihu/web/fetch_column_search_v3", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_zhihu_web_fetch_column_search_v3", "method": "GET", "path": "/apis/v1/tikhub/zhihu/web/fetch_column_search_v3" }, "parameters": [ { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Search Keywords", "title": "Keyword" }, "description": "Search Keywords" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string", "description": "Number of columns per page", "default": "20", "title": "Limit" }, "description": "Number of columns per page" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "string", "description": "Offset", "default": "0", "title": "Offset" }, "description": "Offset" }, { "name": "search_hash_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Search Hash ID", "default": "", "title": "Search Hash Id" }, "description": "Search Hash ID" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:d1e5877cc4e349c0ca12bf8f331cd0bd2b3e063566c5d8bc894cdfd439378917" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-zhihu-web-fetch_column_search_v3" } }, "/apis/v1/tikhub/zhihu/web/fetch_comment_v5": { "get": { "description": "Zhihu (web).\n\n### Purpose:\n- Get Zhihu Comment V5\n### Parameters:\n- answer_id: Answer ID\n- order_by: Sort\n - score Hottest Sort\n - ts Latest Sort\n- limit: Number of comments per page\n- offset: Offset/Page Number\n### Returns:\n- Zhihu Comment V5\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_zhihu_web_fetch_comment_v5", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Zhihu Comment V5", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "zhihu fetch_comment", "tags": [ "tikhub.zhihu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "57452fdb7196" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/zhihu/web/fetch_comment_v5", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_zhihu_web_fetch_comment_v5", "method": "GET", "path": "/apis/v1/tikhub/zhihu/web/fetch_comment_v5" }, "parameters": [ { "name": "answer_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Answer ID", "title": "Answer Id" }, "description": "Answer ID" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string", "description": "Number of comments per page", "default": "20", "title": "Limit" }, "description": "Number of comments per page" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "string", "description": "Offset", "default": "", "title": "Offset" }, "description": "Offset" }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "description": "Sort\n - score Hottest Sort\n - ts Latest Sort", "default": "score", "title": "Order By" }, "description": "Sort\n - score Hottest Sort\n - ts Latest Sort" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:8ccdd6751c02c82bcb68af4d1c91c161fa0502a8a3b242081a0f1c587f7cfe93" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-zhihu-web-fetch_comment_v5" } }, "/apis/v1/tikhub/zhihu/web/fetch_ebook_search_v3": { "get": { "description": "Zhihu (web).\n\n### Purpose:\n- Get Zhihu Ebook Search V3\n### Parameters:\n- keyword: Search Keywords\n- offset: Offset\n- limit: Number of ebooks per page\n- search_hash_id: Search Hash ID\n### Returns:\n- Zhihu Ebook Search V3\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_zhihu_web_fetch_ebook_search_v3", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Zhihu Ebook Search V3", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "zhihu fetch_ebook_search", "tags": [ "tikhub.zhihu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "521f7eb72606" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/zhihu/web/fetch_ebook_search_v3", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_zhihu_web_fetch_ebook_search_v3", "method": "GET", "path": "/apis/v1/tikhub/zhihu/web/fetch_ebook_search_v3" }, "parameters": [ { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Search Keywords", "title": "Keyword" }, "description": "Search Keywords" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string", "description": "Number of ebooks per page", "default": "20", "title": "Limit" }, "description": "Number of ebooks per page" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "string", "description": "Offset", "default": "0", "title": "Offset" }, "description": "Offset" }, { "name": "search_hash_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Search Hash ID", "default": "", "title": "Search Hash Id" }, "description": "Search Hash ID" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e6edaea6b5293cccb5c6ef342068908bb64edbad4dcbc54de0806b1e22777fac" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-zhihu-web-fetch_ebook_search_v3" } }, "/apis/v1/tikhub/zhihu/web/fetch_hot_list": { "get": { "description": "Zhihu (web).\n\n### Purpose:\n- Get Zhihu Hot List\n### Parameters:\n- limit: Number of articles per page\n- desktop: Is it a desktop\n### Returns:\n- Zhihu Hot List\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_zhihu_web_fetch_hot_list", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Zhihu Hot List", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "zhihu fetch_hot_list", "tags": [ "tikhub.zhihu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "6a8f41da35bc" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/zhihu/web/fetch_hot_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_zhihu_web_fetch_hot_list", "method": "GET", "path": "/apis/v1/tikhub/zhihu/web/fetch_hot_list" }, "parameters": [ { "name": "desktop", "in": "query", "required": false, "schema": { "type": "string", "description": "Is it a desktop", "default": "true", "title": "Desktop" }, "description": "Is it a desktop" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string", "description": "Number of articles per page", "default": "50", "title": "Limit" }, "description": "Number of articles per page" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:941b6e84356b737df23349611cfcd0e4cb202ca966e752a9125f5d6126419403" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-zhihu-web-fetch_hot_list" } }, "/apis/v1/tikhub/zhihu/web/fetch_hot_recommend": { "get": { "description": "Zhihu (web).\n\n### Purpose:\n- Get Zhihu Hot Recommend\n### Parameters:\n- offset: Offset\n- page_number: Page Number\n- session_token: Session Token\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_zhihu_web_fetch_hot_recommend", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "zhihu fetch_hot_recommend", "tags": [ "tikhub.zhihu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "23b12df5afea" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/zhihu/web/fetch_hot_recommend", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_zhihu_web_fetch_hot_recommend", "method": "GET", "path": "/apis/v1/tikhub/zhihu/web/fetch_hot_recommend" }, "parameters": [ { "name": "offset", "in": "query", "required": false, "schema": { "type": "string", "description": "Offset", "default": "0", "title": "Offset" }, "description": "Offset" }, { "name": "page_number", "in": "query", "required": false, "schema": { "type": "string", "description": "Page Number", "default": "1", "title": "Page Number" }, "description": "Page Number" }, { "name": "session_token", "in": "query", "required": false, "schema": { "type": "string", "description": "Session Token", "default": "", "title": "Session Token" }, "description": "Session Token" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:e56c0f64759022cecb5502df30fd08faeb446c6d3a60cfc5fa77fb25dd390b27" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-zhihu-web-fetch_hot_recommend" } }, "/apis/v1/tikhub/zhihu/web/fetch_pin_comments": { "get": { "description": "Zhihu (web).\n\n### Purpose:\n- Get the comments of a Zhihu pin\n### Parameters:\n- pin_id: Pin ID\n- order_by: Sort, score=default, ts=newest\n- limit: Number of comments per page\n- offset: Offset, take the cursor from the response for paging\n### Returns:\n- Zhihu Pin Comments\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_zhihu_web_fetch_pin_comments", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Zhihu Pin Comments", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "zhihu fetch_pin_comments", "tags": [ "tikhub.zhihu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "34ea9e6f3b03" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/zhihu/web/fetch_pin_comments", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_zhihu_web_fetch_pin_comments", "method": "GET", "path": "/apis/v1/tikhub/zhihu/web/fetch_pin_comments" }, "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "string", "description": "Number of comments per page", "default": "20", "title": "Limit" }, "description": "Number of comments per page" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "string", "description": "Offset from response cursor (for pagination)", "default": "", "title": "Offset" }, "description": "Offset from response cursor (for pagination)" }, { "name": "order_by", "in": "query", "required": false, "schema": { "enum": [ "score", "ts" ], "type": "string", "description": "Sort: score=default, ts=newest", "default": "score", "title": "Order By" }, "description": "Sort: score=default, ts=newest" }, { "name": "pin_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Pin ID", "title": "Pin Id" }, "description": "Pin ID" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:8f040999b93acdebe98db87f2a8b0b73a51f4ef1f07329385a9bb0ee78d43b62" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-zhihu-web-fetch_pin_comments" } }, "/apis/v1/tikhub/zhihu/web/fetch_pin_detail": { "get": { "description": "Zhihu (web).\n\n### Purpose:\n- Get the detail of a single Zhihu pin\n### Parameters:\n- pin_id: Pin ID\n### Returns:\n- Zhihu Pin Detail\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_zhihu_web_fetch_pin_detail", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Zhihu Pin Detail", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "zhihu fetch_pin_detail", "tags": [ "tikhub.zhihu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "5601adfb50a6" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/zhihu/web/fetch_pin_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_zhihu_web_fetch_pin_detail", "method": "GET", "path": "/apis/v1/tikhub/zhihu/web/fetch_pin_detail" }, "parameters": [ { "name": "pin_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Pin ID", "title": "Pin Id" }, "description": "Pin ID" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:cca7bc0fd0bc23505e553ac949a358ad4d2acc0d422501d891e5f888cc71d22a" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-zhihu-web-fetch_pin_detail" } }, "/apis/v1/tikhub/zhihu/web/fetch_preset_search": { "get": { "description": "Zhihu (web).\n\n### Purpose:\n- Get Zhihu Preset Search\n### Parameters:\n- None\n### Returns:\n- Zhihu Preset Search\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_zhihu_web_fetch_preset_search", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Zhihu Preset Search", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "zhihu fetch_preset_search", "tags": [ "tikhub.zhihu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "40aea912e248" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/zhihu/web/fetch_preset_search", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_zhihu_web_fetch_preset_search", "method": "GET", "path": "/apis/v1/tikhub/zhihu/web/fetch_preset_search" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:0d214dfd6b5e921d2ab2fa197f6019fced6cc0ce7d35953e126e621940f430d0" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-zhihu-web-fetch_preset_search" } }, "/apis/v1/tikhub/zhihu/web/fetch_question_answers": { "get": { "description": "Zhihu (web).\n\n### Purpose:\n- Get Zhihu Question Answers List\n### Parameters:\n- question_id: Question ID\n- cursor: Pagination cursor for next page, extracted from response fields\n- limit: Number of answers per page, default 5\n- offset: Offset, default 0\n- order: Sort order, default=default sort, updated=sort by time\n- session_id: Session ID for pagination state, extracted from response fields\n### Returns:\n- Zhihu Question Answers List Data\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_zhihu_web_fetch_question_answers", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Zhihu Question Answers List Data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "zhihu fetch_question_answers", "tags": [ "tikhub.zhihu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "3deeaeca0c98" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/zhihu/web/fetch_question_answers", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_zhihu_web_fetch_question_answers", "method": "GET", "path": "/apis/v1/tikhub/zhihu/web/fetch_question_answers" }, "parameters": [ { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "description": "Pagination cursor for next page, extracted from response fields", "default": "", "title": "Cursor" }, "description": "Pagination cursor for next page, extracted from response fields" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number of answers per page, default 5", "default": 5, "title": "Limit" }, "description": "Number of answers per page, default 5" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "description": "Offset, default 0", "default": 0, "title": "Offset" }, "description": "Offset, default 0" }, { "name": "order", "in": "query", "required": false, "schema": { "type": "string", "description": "Sort order: default=default sort, updated=sort by time", "default": "default", "title": "Order" }, "description": "Sort order: default=default sort, updated=sort by time" }, { "name": "question_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Question ID", "title": "Question Id" }, "description": "Question ID" }, { "name": "session_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Session ID for pagination state, extracted from response fields", "default": "", "title": "Session Id" }, "description": "Session ID for pagination state, extracted from response fields" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:95add42b18dfaaa839368e8f23303c4ab4c974ddc399b065bd34655730a5c742" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-zhihu-web-fetch_question_answers" } }, "/apis/v1/tikhub/zhihu/web/fetch_question_detail": { "get": { "description": "Zhihu (web).\n\n### Purpose:\n- Get Zhihu Question Detail (title / description / stats / topics, etc.)\n### Parameters:\n- question_id: Question ID\n### Returns:\n- Zhihu Question Detail\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_zhihu_web_fetch_question_detail", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Zhihu Question Detail", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "zhihu fetch_question_detail", "tags": [ "tikhub.zhihu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "1c966e700cce" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/zhihu/web/fetch_question_detail", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_zhihu_web_fetch_question_detail", "method": "GET", "path": "/apis/v1/tikhub/zhihu/web/fetch_question_detail" }, "parameters": [ { "name": "question_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Question ID", "title": "Question Id" }, "description": "Question ID" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:24cd7cc56572ebd214166ebe43b82e9242851f8f9a0543bd3aea8d6178bdcb5a" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-zhihu-web-fetch_question_detail" } }, "/apis/v1/tikhub/zhihu/web/fetch_recommend_followees": { "get": { "description": "Zhihu (web).\n\n### Purpose:\n- Get Zhihu Recommend Followees\n### Parameters:\n- None\n### Returns:\n- Zhihu Recommend Followees\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_zhihu_web_fetch_recommend_followees", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Zhihu Recommend Followees", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "zhihu fetch_recommend_followees", "tags": [ "tikhub.zhihu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "1dc7d3f965d8" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/zhihu/web/fetch_recommend_followees", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_zhihu_web_fetch_recommend_followees", "method": "GET", "path": "/apis/v1/tikhub/zhihu/web/fetch_recommend_followees" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:329703fe86afefdec305b3ef7c40c7e3f229f0559a848e1cca41549a36d8b265" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-zhihu-web-fetch_recommend_followees" } }, "/apis/v1/tikhub/zhihu/web/fetch_salt_search_v3": { "get": { "description": "Zhihu (web).\n\n### Purpose:\n- Get Zhihu Salt Search V3\n### Parameters:\n- keyword: Search Keywords\n- offset: Offset\n- limit: Number of contents per page\n- search_hash_id: Search Hash ID\n### Returns:\n- Zhihu Salt Search V3\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_zhihu_web_fetch_salt_search_v3", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Zhihu Salt Search V3", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "zhihu fetch_salt_search", "tags": [ "tikhub.zhihu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "7e0150c6a14d" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/zhihu/web/fetch_salt_search_v3", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_zhihu_web_fetch_salt_search_v3", "method": "GET", "path": "/apis/v1/tikhub/zhihu/web/fetch_salt_search_v3" }, "parameters": [ { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Search Keywords", "title": "Keyword" }, "description": "Search Keywords" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string", "description": "Number of contents per page", "default": "20", "title": "Limit" }, "description": "Number of contents per page" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "string", "description": "Offset", "default": "0", "title": "Offset" }, "description": "Offset" }, { "name": "search_hash_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Search Hash ID", "default": "", "title": "Search Hash Id" }, "description": "Search Hash ID" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:6d539b4d6c6eb7af38c042491ab6d8468ea9d480883811daaae4bc058f3e5504" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-zhihu-web-fetch_salt_search_v3" } }, "/apis/v1/tikhub/zhihu/web/fetch_scholar_search_v3": { "post": { "description": "Zhihu (web).\n\n### Purpose\n- Get Zhihu Scholar Search V3\n\n### Parameters\n- keyword: Search Keywords\n- offset: Offset\n- limit: Number of papers per page\n- Root JSON body: Object containing the filter fields.\n\n### Returns\n- Zhihu Scholar Search V3\n\n### Request body\nSend filter fields as a JSON object at the root of the request body.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "post_tikhub_zhihu_web_fetch_scholar_search_v3", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Zhihu Scholar Search V3", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "zhihu fetch_scholar_search", "tags": [ "tikhub.zhihu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "ba5203188f30" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/zhihu/web/fetch_scholar_search_v3", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "post_tikhub_zhihu_web_fetch_scholar_search_v3", "method": "POST", "path": "/apis/v1/tikhub/zhihu/web/fetch_scholar_search_v3" }, "parameters": [ { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Search Keywords", "title": "Keyword" }, "description": "Search Keywords" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string", "description": "Number of papers per page", "default": "25", "title": "Limit" }, "description": "Number of papers per page" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "string", "description": "Offset", "default": "0", "title": "Offset" }, "description": "Offset" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "description": "Filter Fields", "default": { "advanced_filter": "keywords,title,authors,abstract", "indexed_by": "", "classification": "" }, "title": "Filter Fields" } } } }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:fa2242d57b9b8d1020eff538c4a28a00f5e59d93248410a29fd4fd06cceb6b05" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/post_tikhub-zhihu-web-fetch_scholar_search_v3" } }, "/apis/v1/tikhub/zhihu/web/fetch_search_recommend": { "get": { "description": "Zhihu (web).\n\n### Purpose:\n- Get Zhihu Search Recommend\n### Parameters:\n- None\n### Returns:\n- Zhihu Search Recommend\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_zhihu_web_fetch_search_recommend", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Zhihu Search Recommend", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "zhihu fetch_search_recommend", "tags": [ "tikhub.zhihu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "61234e01fbdb" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/zhihu/web/fetch_search_recommend", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_zhihu_web_fetch_search_recommend", "method": "GET", "path": "/apis/v1/tikhub/zhihu/web/fetch_search_recommend" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:2efc9de3f36c46134a880ccc27a5a06aea868e7f2d34f3aeadbe77ff356924ef" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-zhihu-web-fetch_search_recommend" } }, "/apis/v1/tikhub/zhihu/web/fetch_search_suggest": { "get": { "description": "Zhihu (web).\n\n### Purpose:\n- Get Zhihu Search Suggest\n### Parameters:\n- keyword: Search Keywords\n### Returns:\n- Zhihu Search Suggest\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_zhihu_web_fetch_search_suggest", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Zhihu Search Suggest", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "zhihu fetch_search_suggest", "tags": [ "tikhub.zhihu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "ac458c208d61" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/zhihu/web/fetch_search_suggest", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_zhihu_web_fetch_search_suggest", "method": "GET", "path": "/apis/v1/tikhub/zhihu/web/fetch_search_suggest" }, "parameters": [ { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Search Keywords", "title": "Keyword" }, "description": "Search Keywords" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:f7ad52155c2173423f7b35091504d55cd082825145121edb5e3047a591dbc9ad" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-zhihu-web-fetch_search_suggest" } }, "/apis/v1/tikhub/zhihu/web/fetch_sub_comment_v5": { "get": { "description": "Zhihu (web).\n\n### Purpose:\n- Get Zhihu Sub Comment V5\n### Parameters:\n- comment_id: Comment ID\n- order_by: Sort\n - score Hottest Sort\n - ts Latest Sort\n- limit: Number of comments per page\n- offset: Offset/Page Number\n### Returns:\n- Zhihu Sub Comment V5\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_zhihu_web_fetch_sub_comment_v5", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Zhihu Sub Comment V5", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "zhihu fetch_sub_comment", "tags": [ "tikhub.zhihu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "af6941aeb136" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/zhihu/web/fetch_sub_comment_v5", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_zhihu_web_fetch_sub_comment_v5", "method": "GET", "path": "/apis/v1/tikhub/zhihu/web/fetch_sub_comment_v5" }, "parameters": [ { "name": "comment_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Comment ID", "title": "Comment Id" }, "description": "Comment ID" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string", "description": "Number of comments per page", "default": "20", "title": "Limit" }, "description": "Number of comments per page" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "string", "description": "Offset", "default": "", "title": "Offset" }, "description": "Offset" }, { "name": "order_by", "in": "query", "required": false, "schema": { "type": "string", "description": "Sort\n - score Hottest Sort\n - ts Latest Sort", "default": "score", "title": "Order By" }, "description": "Sort\n - score Hottest Sort\n - ts Latest Sort" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:3401ffbac2976477073bee63ee6bbe81547968058cadf19921853a3ce9a7244b" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-zhihu-web-fetch_sub_comment_v5" } }, "/apis/v1/tikhub/zhihu/web/fetch_topic_search_v3": { "get": { "description": "Zhihu (web).\n\n### Purpose:\n- Get Zhihu Topic Search V3\n### Parameters:\n- keyword: Search Keywords\n- offset: Offset\n- limit: Number of topics per page\n### Returns:\n- Zhihu Topic Search V3\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_zhihu_web_fetch_topic_search_v3", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Zhihu Topic Search V3", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "zhihu fetch_topic_search", "tags": [ "tikhub.zhihu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "27273843da12" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/zhihu/web/fetch_topic_search_v3", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_zhihu_web_fetch_topic_search_v3", "method": "GET", "path": "/apis/v1/tikhub/zhihu/web/fetch_topic_search_v3" }, "parameters": [ { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Search Keywords", "title": "Keyword" }, "description": "Search Keywords" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string", "description": "Number of topics per page", "default": "25", "title": "Limit" }, "description": "Number of topics per page" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "string", "description": "Offset", "default": "0", "title": "Offset" }, "description": "Offset" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:048ca9ba67bfe1efee1e2676b9e52da3501d23f141003f493d6f99963e731404" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-zhihu-web-fetch_topic_search_v3" } }, "/apis/v1/tikhub/zhihu/web/fetch_user_answers": { "get": { "description": "Zhihu (web).\n\n### Purpose:\n- Get Zhihu User Answers\n### Parameters:\n- user_url_token: User ID\n- offset: Offset\n- limit: Number of answers per page\n- sort_type: Sort Type\n - created Sort by creation time\n - voteups Sort by vote ups\n### Returns:\n- Zhihu User Answers\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_zhihu_web_fetch_user_answers", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- Zhihu User Answers", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "zhihu fetch_user_answers", "tags": [ "tikhub.zhihu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "269d999e589e" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/zhihu/web/fetch_user_answers", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_zhihu_web_fetch_user_answers", "method": "GET", "path": "/apis/v1/tikhub/zhihu/web/fetch_user_answers" }, "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "string", "description": "Number of answers per page", "default": "20", "title": "Limit" }, "description": "Number of answers per page" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "string", "description": "Offset", "default": "0", "title": "Offset" }, "description": "Offset" }, { "name": "sort_type", "in": "query", "required": false, "schema": { "enum": [ "created", "voteups" ], "type": "string", "description": "Sort Type\n - created Sort by creation time\n - voteups Sort by vote ups", "default": "created", "title": "Sort Type" }, "description": "Sort Type\n - created Sort by creation time\n - voteups Sort by vote ups" }, { "name": "user_url_token", "in": "query", "required": true, "schema": { "type": "string", "description": "User ID", "title": "User Url Token" }, "description": "User ID" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:69530f41789991329a3025588ae70b6246994bb54e4aa8858e15a7ee0f3964c3" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-zhihu-web-fetch_user_answers" } }, "/apis/v1/tikhub/zhihu/web/fetch_user_articles": { "get": { "description": "Zhihu (web).\n\n### Purpose:\n- Get Zhihu User Articles\n### Parameters:\n- user_url_token: User ID\n- offset: Offset\n- limit: Number of articles per page\n- sort_type: Sort Type\n - created Sort by creation time\n - voteups Sort by vote ups\n### Returns:\n- Zhihu User Articles\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_zhihu_web_fetch_user_articles", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Zhihu User Articles", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "zhihu fetch_user_articles", "tags": [ "tikhub.zhihu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "6eb201ad1368" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/zhihu/web/fetch_user_articles", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_zhihu_web_fetch_user_articles", "method": "GET", "path": "/apis/v1/tikhub/zhihu/web/fetch_user_articles" }, "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "string", "description": "Number of articles per page", "default": "20", "title": "Limit" }, "description": "Number of articles per page" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "string", "description": "Offset", "default": "0", "title": "Offset" }, "description": "Offset" }, { "name": "sort_type", "in": "query", "required": false, "schema": { "enum": [ "created", "voteups" ], "type": "string", "description": "Sort Type\n - created Sort by creation time\n - voteups Sort by vote ups", "default": "created", "title": "Sort Type" }, "description": "Sort Type\n - created Sort by creation time\n - voteups Sort by vote ups" }, { "name": "user_url_token", "in": "query", "required": true, "schema": { "type": "string", "description": "User ID", "title": "User Url Token" }, "description": "User ID" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:76b128cf9403911645a8889c298cad8285c117b3d5fa4eab40a216acd4c708b0" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-zhihu-web-fetch_user_articles" } }, "/apis/v1/tikhub/zhihu/web/fetch_user_collections": { "get": { "description": "Zhihu (web).\n\n### Purpose:\n- Get collections **created** by a Zhihu user (distinct from followed favlists)\n### Parameters:\n- user_url_token: User ID\n- offset: Offset\n- limit: Number of collections per page\n### Returns:\n- Zhihu User Created Collections\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_zhihu_web_fetch_user_collections", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Zhihu User Created Collections", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "zhihu fetch_user_collections", "tags": [ "tikhub.zhihu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "27ae8d148689" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/zhihu/web/fetch_user_collections", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_zhihu_web_fetch_user_collections", "method": "GET", "path": "/apis/v1/tikhub/zhihu/web/fetch_user_collections" }, "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "string", "description": "Number of collections per page", "default": "20", "title": "Limit" }, "description": "Number of collections per page" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "string", "description": "Offset", "default": "0", "title": "Offset" }, "description": "Offset" }, { "name": "user_url_token", "in": "query", "required": true, "schema": { "type": "string", "description": "User ID", "title": "User Url Token" }, "description": "User ID" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:5b861b8b3f214c3d71ab341e114c2dbd61f52ca90a381ac13c26067680af17cb" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-zhihu-web-fetch_user_collections" } }, "/apis/v1/tikhub/zhihu/web/fetch_user_follow_collections": { "get": { "description": "Zhihu (web).\n\n### Purpose:\n- Get Zhihu User Follow Collections\n### Parameters:\n- user_url_token: User ID\n- offset: Offset\n- limit: Number of collections per page\n### Returns:\n- Zhihu User Follow Collections\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_zhihu_web_fetch_user_follow_collections", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Zhihu User Follow Collections", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "zhihu fetch_user_follow_collections", "tags": [ "tikhub.zhihu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "28786011aae9" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/zhihu/web/fetch_user_follow_collections", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_zhihu_web_fetch_user_follow_collections", "method": "GET", "path": "/apis/v1/tikhub/zhihu/web/fetch_user_follow_collections" }, "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "string", "description": "Number of collections per page", "default": "20", "title": "Limit" }, "description": "Number of collections per page" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "string", "description": "Offset", "default": "0", "title": "Offset" }, "description": "Offset" }, { "name": "user_url_token", "in": "query", "required": true, "schema": { "type": "string", "description": "User ID", "title": "User Url Token" }, "description": "User ID" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:8a5f53ea14e835a748723cf114b8d26e2e37f778f47fd68d86a412de6f147123" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-zhihu-web-fetch_user_follow_collections" } }, "/apis/v1/tikhub/zhihu/web/fetch_user_follow_columns": { "get": { "description": "Zhihu (web).\n\n### Purpose:\n- Get Zhihu User Columns\n### Parameters:\n- user_url_token: User ID\n- offset: Offset\n- limit: Number of columns per page\n### Returns:\n- Zhihu User Columns\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_zhihu_web_fetch_user_follow_columns", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Zhihu User Columns", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "zhihu fetch_user_follow_columns", "tags": [ "tikhub.zhihu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "33ded0f81f02" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/zhihu/web/fetch_user_follow_columns", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_zhihu_web_fetch_user_follow_columns", "method": "GET", "path": "/apis/v1/tikhub/zhihu/web/fetch_user_follow_columns" }, "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "string", "description": "Number of columns per page", "default": "20", "title": "Limit" }, "description": "Number of columns per page" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "string", "description": "Offset", "default": "0", "title": "Offset" }, "description": "Offset" }, { "name": "user_url_token", "in": "query", "required": true, "schema": { "type": "string", "description": "User ID", "title": "User Url Token" }, "description": "User ID" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:86d3158085b31c8437e542dbc54b65a16897d0848ec5239d8a91e2181d23ea26" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-zhihu-web-fetch_user_follow_columns" } }, "/apis/v1/tikhub/zhihu/web/fetch_user_follow_questions": { "get": { "description": "Zhihu (web).\n\n### Purpose:\n- Get Zhihu User Follow Questions\n### Parameters:\n- user_url_token: User ID\n- offset: Offset\n- limit: Number of questions per page\n### Returns:\n- Zhihu User Follow Questions\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_zhihu_web_fetch_user_follow_questions", "responses": { "200": { "description": "Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`.\n\n### Returns\n- Zhihu User Follow Questions", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "zhihu fetch_user_follow_questions", "tags": [ "tikhub.zhihu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "c4382049f333" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/zhihu/web/fetch_user_follow_questions", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_zhihu_web_fetch_user_follow_questions", "method": "GET", "path": "/apis/v1/tikhub/zhihu/web/fetch_user_follow_questions" }, "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "string", "description": "Number of questions per page", "default": "20", "title": "Limit" }, "description": "Number of questions per page" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "string", "description": "Offset", "default": "0", "title": "Offset" }, "description": "Offset" }, { "name": "user_url_token", "in": "query", "required": true, "schema": { "type": "string", "description": "User ID", "title": "User Url Token" }, "description": "User ID" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:4a0e2abb49b28ea3c60870fcbe2169ba0c8e66892ff41bbf5ef791067bf2b0ec" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-zhihu-web-fetch_user_follow_questions" } }, "/apis/v1/tikhub/zhihu/web/fetch_user_follow_topics": { "get": { "description": "Zhihu (web).\n\n### Purpose:\n- Get Zhihu User Follow Topics\n### Parameters:\n- user_url_token: User ID\n- offset: Offset\n- limit: Number of topics per page\n### Returns:\n- Zhihu User Follow Topics\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_zhihu_web_fetch_user_follow_topics", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Zhihu User Follow Topics", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "zhihu fetch_user_follow_topics", "tags": [ "tikhub.zhihu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "19e52141f968" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/zhihu/web/fetch_user_follow_topics", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_zhihu_web_fetch_user_follow_topics", "method": "GET", "path": "/apis/v1/tikhub/zhihu/web/fetch_user_follow_topics" }, "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "string", "description": "Number of topics per page", "default": "20", "title": "Limit" }, "description": "Number of topics per page" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "string", "description": "Offset", "default": "0", "title": "Offset" }, "description": "Offset" }, { "name": "user_url_token", "in": "query", "required": true, "schema": { "type": "string", "description": "User ID", "title": "User Url Token" }, "description": "User ID" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:8564fcd61f87fcda4e42ac2667360b119978fc305eba67783cfbecb576720284" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-zhihu-web-fetch_user_follow_topics" } }, "/apis/v1/tikhub/zhihu/web/fetch_user_followees": { "get": { "description": "Zhihu (web).\n\n### Purpose:\n- Get Zhihu User Following\n### Parameters:\n- user_url_token: User ID\n- offset: Offset\n- limit: Number of users per page\n### Returns:\n- Zhihu User Following\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_zhihu_web_fetch_user_followees", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Zhihu User Following", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "zhihu fetch_user_followees", "tags": [ "tikhub.zhihu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "5d6d1a12acfc" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/zhihu/web/fetch_user_followees", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_zhihu_web_fetch_user_followees", "method": "GET", "path": "/apis/v1/tikhub/zhihu/web/fetch_user_followees" }, "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "string", "description": "Number of users per page", "default": "20", "title": "Limit" }, "description": "Number of users per page" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "string", "description": "Offset", "default": "0", "title": "Offset" }, "description": "Offset" }, { "name": "user_url_token", "in": "query", "required": true, "schema": { "type": "string", "description": "User ID", "title": "User Url Token" }, "description": "User ID" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:0ed993ffb549716336e66c4dcb74d62acd2a950d79fd1d721a8d9a0ebc9da8cf" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-zhihu-web-fetch_user_followees" } }, "/apis/v1/tikhub/zhihu/web/fetch_user_followers": { "get": { "description": "Zhihu (web).\n\n### Purpose:\n- Get Zhihu User Followers\n### Parameters:\n- user_url_token: User ID\n- offset: Offset\n- limit: Number of users per page\n### Returns:\n- Zhihu User Followers\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_zhihu_web_fetch_user_followers", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Zhihu User Followers", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "zhihu fetch_user_followers", "tags": [ "tikhub.zhihu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "818f5c22b946" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/zhihu/web/fetch_user_followers", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_zhihu_web_fetch_user_followers", "method": "GET", "path": "/apis/v1/tikhub/zhihu/web/fetch_user_followers" }, "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "string", "description": "Number of users per page", "default": "20", "title": "Limit" }, "description": "Number of users per page" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "string", "description": "Offset", "default": "0", "title": "Offset" }, "description": "Offset" }, { "name": "user_url_token", "in": "query", "required": true, "schema": { "type": "string", "description": "User ID", "title": "User Url Token" }, "description": "User ID" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:6333fd6f1ed20a0afee3ac8112d288139260050cbcc9aa145589249bb2796643" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-zhihu-web-fetch_user_followers" } }, "/apis/v1/tikhub/zhihu/web/fetch_user_included_articles": { "get": { "description": "Zhihu (web).\n\n### Purpose:\n- Get Zhihu User Included Articles\n### Parameters:\n- user_url_token: User ID\n- offset: Offset\n- limit: Number of articles per page\n### Returns:\n- Zhihu User Included Articles\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_zhihu_web_fetch_user_included_articles", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Zhihu User Included Articles", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "zhihu fetch_user_included_articles", "tags": [ "tikhub.zhihu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "fceec666cecf" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/zhihu/web/fetch_user_included_articles", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_zhihu_web_fetch_user_included_articles", "method": "GET", "path": "/apis/v1/tikhub/zhihu/web/fetch_user_included_articles" }, "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "string", "description": "Number of articles per page", "default": "20", "title": "Limit" }, "description": "Number of articles per page" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "string", "description": "Offset", "default": "0", "title": "Offset" }, "description": "Offset" }, { "name": "user_url_token", "in": "query", "required": true, "schema": { "type": "string", "description": "User ID", "title": "User Url Token" }, "description": "User ID" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:16440558d892c3cdcf0a478cf227d97a74a7ee96c8b00f2c1a87dacf57dd535d" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-zhihu-web-fetch_user_included_articles" } }, "/apis/v1/tikhub/zhihu/web/fetch_user_info": { "get": { "description": "Zhihu (web).\n\n### Purpose:\n- Get Zhihu User Info\n### Parameters:\n- user_url_token: User ID\n### Returns:\n- Zhihu User Info\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_zhihu_web_fetch_user_info", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Zhihu User Info", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "zhihu fetch_user_info", "tags": [ "tikhub.zhihu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "e642d470b721" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/zhihu/web/fetch_user_info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_zhihu_web_fetch_user_info", "method": "GET", "path": "/apis/v1/tikhub/zhihu/web/fetch_user_info" }, "parameters": [ { "name": "user_url_token", "in": "query", "required": true, "schema": { "type": "string", "description": "User ID", "title": "User Url Token" }, "description": "User ID" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:8f0adcdf9935cb9abfabb37fa89a82903cb8b3fee055e7b39456bcdb80119672" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-zhihu-web-fetch_user_info" } }, "/apis/v1/tikhub/zhihu/web/fetch_user_pins": { "get": { "description": "Zhihu (web).\n\n### Purpose:\n- Get a Zhihu user's pins (moments) list\n### Parameters:\n- user_url_token: User ID\n- offset: Offset\n- limit: Number of pins per page\n### Returns:\n- Zhihu User Pins\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_zhihu_web_fetch_user_pins", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Zhihu User Pins", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "zhihu fetch_user_pins", "tags": [ "tikhub.zhihu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "4ac76ae8212c" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/zhihu/web/fetch_user_pins", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_zhihu_web_fetch_user_pins", "method": "GET", "path": "/apis/v1/tikhub/zhihu/web/fetch_user_pins" }, "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "string", "description": "Number of pins per page", "default": "20", "title": "Limit" }, "description": "Number of pins per page" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "string", "description": "Offset", "default": "0", "title": "Offset" }, "description": "Offset" }, { "name": "user_url_token", "in": "query", "required": true, "schema": { "type": "string", "description": "User ID", "title": "User Url Token" }, "description": "User ID" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:4ac048beefc2a51c16c0c030ff8d3169f997fa16db523c03758221dfba75ab38" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-zhihu-web-fetch_user_pins" } }, "/apis/v1/tikhub/zhihu/web/fetch_user_search_v3": { "get": { "description": "Zhihu (web).\n\n### Purpose:\n- Get Zhihu User Search V3\n### Parameters:\n- keyword: Search Keywords\n- offset: Offset\n- limit: Number of users per page\n### Returns:\n- Zhihu User Search V3\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_zhihu_web_fetch_user_search_v3", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Zhihu User Search V3", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "zhihu fetch_user_search", "tags": [ "tikhub.zhihu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "fc57fab66f24" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/zhihu/web/fetch_user_search_v3", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_zhihu_web_fetch_user_search_v3", "method": "GET", "path": "/apis/v1/tikhub/zhihu/web/fetch_user_search_v3" }, "parameters": [ { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Search Keywords", "title": "Keyword" }, "description": "Search Keywords" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string", "description": "Number of users per page", "default": "25", "title": "Limit" }, "description": "Number of users per page" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "string", "description": "Offset", "default": "0", "title": "Offset" }, "description": "Offset" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:2ed32569341311e5cc622ba871b7d6abd18cd9041b6a8354b5ef98a50e6272ed" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-zhihu-web-fetch_user_search_v3" } }, "/apis/v1/tikhub/zhihu/web/fetch_user_segments": { "get": { "description": "Zhihu (web).\n\n### Purpose:\n- Get a Zhihu user's highlighted segments (lineComments)\n### Parameters:\n- user_url_token: MUST be the user's **member hash id** (e.g. c72367...), not the url_token\n- content_type: Content type, all for all\n- offset: Offset\n- limit: Number per page\n### Returns:\n- Zhihu User Segments\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_zhihu_web_fetch_user_segments", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Zhihu User Segments", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "zhihu fetch_user_segments", "tags": [ "tikhub.zhihu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "e45f43ccf7ab" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/zhihu/web/fetch_user_segments", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_zhihu_web_fetch_user_segments", "method": "GET", "path": "/apis/v1/tikhub/zhihu/web/fetch_user_segments" }, "parameters": [ { "name": "content_type", "in": "query", "required": false, "schema": { "type": "string", "description": "Content type", "default": "all", "title": "Content Type" }, "description": "Content type" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string", "description": "Number per page", "default": "20", "title": "Limit" }, "description": "Number per page" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "string", "description": "Offset", "default": "0", "title": "Offset" }, "description": "Offset" }, { "name": "user_url_token", "in": "query", "required": true, "schema": { "type": "string", "description": "MUST be the user's **member hash id** (e.g. c72367...), not the url_token", "title": "User Url Token" }, "description": "MUST be the user's **member hash id** (e.g. c72367...), not the url_token" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:82fefc11d332220dc52d9ddcf77e2090360c2e331892006dbdaec6be994d6141" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-zhihu-web-fetch_user_segments" } }, "/apis/v1/tikhub/zhihu/web/fetch_video_list": { "get": { "description": "Zhihu (web).\n\n### Purpose:\n- Get Zhihu Video List\n### Parameters:\n- offset: Offset\n- limit: Number of videos per page\n### Returns:\n- Zhihu Video List\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_zhihu_web_fetch_video_list", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Zhihu Video List", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "zhihu fetch_video_list", "tags": [ "tikhub.zhihu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "4792584fde92" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/zhihu/web/fetch_video_list", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_zhihu_web_fetch_video_list", "method": "GET", "path": "/apis/v1/tikhub/zhihu/web/fetch_video_list" }, "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "string", "description": "Number of videos per page", "default": "12", "title": "Limit" }, "description": "Number of videos per page" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "string", "description": "Offset", "default": "0", "title": "Offset" }, "description": "Offset" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:99e9ea5933f4bb17a063116c41d148020ad09f3f47dac3456583ae405fe7194a" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-zhihu-web-fetch_video_list" } }, "/apis/v1/tikhub/zhihu/web/fetch_video_search_v3": { "get": { "description": "Zhihu (web).\n\n### Purpose:\n- Get Zhihu Video Search V3\n### Parameters:\n- keyword: Search Keywords\n- limit: Number of videos per page\n- offset: Offset\n- search_hash_id: Search Hash ID\n### Returns:\n- Zhihu Video Search V3\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_tikhub_zhihu_web_fetch_video_search_v3", "responses": { "200": { "description": "Successful Response\n\n### Returns\n- Zhihu Video Search V3", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response1Fc51B60A782_ResponseModel" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "zhihu fetch_video_search", "tags": [ "tikhub.zhihu" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "core", "x-aisa-passthrough": true, "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" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "36f71dbb9a29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "6a62f042d7fe" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/zhihu/web/fetch_video_search_v3", "x-aisa-validation": "provider", "x-aisa-catalog-id": "tikhub", "x-aisa-runtime-operation": { "operation_id": "get_tikhub_zhihu_web_fetch_video_search_v3", "method": "GET", "path": "/apis/v1/tikhub/zhihu/web/fetch_video_search_v3" }, "parameters": [ { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string", "description": "Search Keywords", "title": "Keyword" }, "description": "Search Keywords" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string", "description": "Number of videos per page", "default": "20", "title": "Limit" }, "description": "Number of videos per page" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "string", "description": "Offset", "default": "0", "title": "Offset" }, "description": "Offset" }, { "name": "search_hash_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Search Hash ID", "default": "", "title": "Search Hash Id" }, "description": "Search Hash ID" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:7f2beb52342a3942a5d55021fdf8ae5b8755502561a8fcb706224876460bd4d8", "converter": "reviewed-official-tikhub-nullability-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:3343a50ed4758e933a52c607dbc89523731bd72a98ff4f0f7b5db72d002acecf", "converter": "reviewed-official-tikhub-region-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/tikhub.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:36a70c51e725ac32adf881f4e0c7535b59adbebd2baf0f46ff8835c455e74c77", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4101a9c96fef0ddfbcc76b9e32aa1ab30472e8103045bfc6b2e8fa8a3fafbe27" }, "scope": "Only2 optional region query declarations from the pinned official SDK; all other fields, authority, policy and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-region-inputs-review.json." }, "scope": "Only supplier-confirmed null acceptance on10 reviewed request operations; existing non-null constraints, all other operations, policy, authority and whole-source clocks retained. See docs/current-source-review-20261017/tikhub-nullability-review.json." }, "content_hash": "sha256:ff28ce4feba75e49d9a850d5bf43ba0bac986982ee26c7190c41d185db243ad8" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/tikhub/get_tikhub-zhihu-web-fetch_video_search_v3" } } } }